Token herstellen

API-Tokens sind eine gute Möglichkeit, sich bei unserer API zu authentifizieren und sich gleichzeitig von Ihrem Benutzernamen und Passwort zu trennen. Wir empfehlen Ihnen daher dringend, diese zu verwenden. Wie Sie Ihren Token verwalten können, erfahren Sie hier. Sie können ein Token mit unserer API erstellen oder auf Unsere Plattform.

Wollen Sie Ihren ersten Token erstellen?, Gehen Sie auf Unsere Plattform

POST

/token

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 HTTP/1.1
Host: api.smsup.ch
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 HTTP/1.1
Host: api.smsup.ch
Authorization: Bearer your.token
Accept: application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<token>
  <name>Best token ever</name>
  <ttl>2678400</ttl>
</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",
  "allowed_ips": [
    "2a01:cb1d:2b9:ef02:2521:4ed1:109a:8fae",
    "192.168.2.0/24",
    "192.168.2.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>