API Merci Facteur /getToken : Obtenir un access token

Base URL API Merci Facteur https://www.merci-facteur.com/api/1.2/prod/service

Endpoint API Merci Facteur https://www.merci-facteur.com/api/1.2/prod/service/getToken

← Retour à la liste des endpoints de l'API Merci Facteur

← Voir ce endpoint dans la doc Swagger

GET /getTokenObtenir un access token
 
Voir dans Swagger →


IMPORTANT :
- Ne demander un access token qu'une seule fois par tranche de 24h. Après execution de getToken, stockez en local l'access token obtenu et refaites une demande lorsqu'il est expiré.
- Ne jamais faire transiter votre Secret Key non hashée.
`En savoir plus sur le hashage de la private key`
`En savoir plus sur les options de génération du token`

Paramètres

NomInTypeDescription
ww-service-signatureheaderstringVotre clé secrète hashée (ne jamais transmettre non hashé).
ww-timestampheaderstringLe timestamp identique à celui utilisé pour hasher la clé secrète.
ww-service-idheaderstringVotre service Id
ww-authorized-ipheaderstringLa ou les adresses IP des serveurs autorisés, séparées par des points-virgules. (si la restriction d'ip a été levée pour votre compte, passez une IP random, comme par exemple 111.111.111).

Request body

Aucun body.

Réponses

HTTP 200 — Objet contenant l'access token

application/json

PropriétéTypeDescription
successbooleantrue si HTTP 200, sinon false
errorstringle code d'erreur en cas d'erreur
tokenstringl'access token à conserver en local tant qu'il est valide
expireintegertimestamp de la date d'expiration du token
HTTP 400 — Erreur (code d'erreur dans l'entête)

application/json

PropriétéTypeDescription
successbooleantrue si HTTP 200, sinon false
errorobjectObjet contenant les infos de l'erreur.
PropriétéTypeDescription
codestringle code d'erreur en cas d'erreur
textstringle message d'erreur correspondant
HTTP 401 — Erreur authentification (code d'erreur dans l'entête : token invalide ou expiré, service-id incorrecte, IP non autorisée)

application/json

PropriétéTypeDescription
successbooleantrue si HTTP 200, sinon false
errorobjectObjet contenant les infos de l'erreur.
PropriétéTypeDescription
codestringle code d'erreur en cas d'erreur
textstringle message d'erreur correspondant


imprimé en france depuis 2004