API Merci Facteur /setUser : Créer un nouvel utilisateur

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/setUser

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

← Voir ce endpoint dans la doc Swagger

POST /setUserCréer un nouvel utilisateur
 
Voir dans Swagger →

Chaque utilisateur aura un carnet d'adresses et un historique des envois. Vous retrouverez ces utilisateurs dans votre interface Merci facteur Pro. L'email indiqué doit être unique et vous permettre d'identifier l'utilisateur. Nous vous conseillons d'enregistrer en local les id d'utilisateurs retournés dans la réonse pour plus de confort d'utilisation de l'API.

Paramètres

NomInTypeDescription
ww-service-idheaderstringVotre service Id
ww-access-tokenheaderstringUn access token valide

Request body

Request body requis

application/x-www-form-urlencoded
PropriétéTypeDescription
emailUserstringEmail du nouvel utilisateur. Peut être fictif mais doit être unique et vous permettre d'identifier l'utilisateur.
first_namestringPrénom de l'utilisateur, vous permet de savoir qui est tel utilisateur.
last_namestringNom de l'utilisateur, vous permet de savoir qui est tel utilisateur.

Réponses

HTTP 200 — Objet contenant le user Id du nouvel utilisateur

application/json

PropriétéTypeDescription
successbooleantrue si HTTP 200, sinon false
errorstringle code d'erreur en cas d'erreur
user_idintegerLe user ID du nouvel utilisateur, à sauvegarder en local
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