Authentification

Pour vous authentifier auprès de notre API, vous avez besoin d'une clé API. Vous pouvez la créer et la consulter dans votre compte dans la section Développeur. Vous pouvez en savoir plus dans notre article d'aide (en allemand).

Créer une clé API maintenant

HTTP Basic Auth

Utilisez HTTP Basic Auth avec votre clé API. La clé API est envoyée directement en tant qu'en-tête, aucun encodage Base64 supplémentaire n'est requis.

Exemple de requête avec HTTP Basic Auth

curl https://gateway.seven.io/api/sms \
  -H 'Authorization: basic VOTRE_CLÉ_API'

OAuth2 avec Bearer Token

L'authentification nécessite qu'une application soit enregistrée chez nous et que le client l'ait autorisée à utiliser l'API.

En savoir plus sur OAuth2.0 →

Exemple de requête avec Bearer Auth

curl https://gateway.seven.io/api/sms \
  -H 'Authorization: Bearer ACCESS_TOKEN'

Authentification par en-tête HTTP

Envoyez votre requête API avec votre clé API dans l'en-tête X-Api-Key

Exemple de requête avec en-tête x-api-key

curl https://gateway.seven.io/api/sms \
  -H 'X-Api-Key: VOTRE_CLÉ_API'
Deprecated

Authentification par paramètre GET/POST ou utilisateur/mot de passe

En alternative aux méthodes mentionnées ci-dessus, nous continuons à prendre en charge l'authentification par clé API en tant que paramètre GET ou POST p.

La transmission par GET en particulier est considérée comme non sécurisée et ne doit donc pas être utilisée. Pour des raisons de compatibilité, l'authentification obsolète par utilisateur/mot de passe est également toujours possible. Ceci est fortement déconseillé.

Afficher les détails
  • Name
    u
    Type
    string
    Optional
    Optional
    Description

    Votre alias de connexion ou votre adresse e-mail. Doit être spécifié si p contient le mot de passe de connexion.

  • Name
    p
    Type
    string
    Description

    Votre clé API ou votre mot de passe de connexion.

Exemples

HTTP GET avec utilisateur/mot de passe

curl "https://gateway.seven.io/api/endpoint?u=VOTRE_LOGIN&p=VOTRE_MOT_DE_PASSE"

HTTP GET avec clé API

curl "https://gateway.seven.io/api/endpoint?p=VOTRE_CLÉ_API"

HTTP POST avec clé API

curl -X POST "https://gateway.seven.io/api/endpoint" \
    -d "p=VOTRE_CLÉ_API"