Token für ein Unterkonto herstellen
Mit dieser Methode können Sie ein Token für ein Unterkonto erstellen.
POST
/token/account/:id
Abfrage-Parameter
id
notwendig
|
Die ID des Kontos, für das Sie ein Token erstellen möchten |
Body-Parameter
name
notwendig
|
Token-Name |
ttl | Die TTL in Sekunden. Standard kein Verfall |
allowed_ips | Verwaltung der zulässigen IPs, die mit diesem Token angefordert werden können (IPv4, IPv6 und cidr sind kompatibel) |
Beispiele
POST /token/account/12542 HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json
{
"token":{
"name": "Best token ever",
"ttl": 2678400,
"allowed_ips": [
"2a01:cb1d:2b9:ef02:2521:4ed1:109a:8fae",
"192.168.2.0/24",
"192.168.2.2"
]
}
}
POST /token/account/12542 HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<token>
<name>Best token ever</name>
</token>
Ergebnisformat
Sobald Sie ein Token erstellt haben, können Sie es nicht mehr abrufen. Denken Sie daran, es zu speichern.
{
"status": 1,
"message": "OK",
"token": "yJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMTY1NiIsImlhdCI6MTUxOTEyMDg2NX0.ZnGgbDC0OI3hPm2UXyl4rxU9JlpMTMBcTJT8RVgJbtQ",
"token_id": "2"
}
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>1</status>
<message>OK</message>
<token>yJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMTY1NiIsImlhdCI6MTUxOTEyMDg2NX0.ZnGgbDC0OI3hPm2UXyl4rxU9JlpMTMBcTJT8RVgJbtQ</token>
<token_id>2</token_id>
</response>