Partenaires toolimo

L'objectif est de permettre à nos partenaires de créer un compte professionnel toolimo facilement et simplement afin de récuperer un token de cet utilisateur.

Celui-ci devra stocker de son côté afin d'être réutilisé lors de l'appel de notre embed/iframe B2B.

Création d'un compte professionnel

La création d'un compte professionnel requière du côté partenaire deux cases à cocher (dites checkbox):

• RGPD : https://toolimo.fr/donnees-personnelles
• CGU : https://toolimo.fr/contract/professional

Modèle de données

Nom	Type	Requis	Condition
firstName	string	oui
lastName	string	oui
phone	string	oui	Doit être au format international
email	string	oui
companyName	string	oui
address	string	oui
zipCode	string	oui
city	string	oui
siret	string	oui	Doit être valide
rgpd	boolean	oui
cgu	boolean	oui	J'accepte les conditions générales de vente lors de l'achat des produits ou services à travers Diag&Go - toolimo, vous acceptez d'être lié par ces Conditions de vente.

Exemple

A transmettre dans le body en tant que raw.

{
    "firstName": "David",
    "lastName":  "Boisvert",
    "phone": "+33214442876",
    "email": "david.boisvert@example.demo",
    "companyName": "delivery",
    "address": "96, Avenue Millies Lacroix",
    "zipCode": "97610",
    "city": "BASCO",
    "siret": "49114690800017",
    "rgpd": true,
    "cgu": true
}

Point de terminaison

La ressource /professional sur le verbe POST.

L'authentification se fait par jeton.

Ces deux headers sont requis:

header	valeur
X-AUTH-TOKEN	votre token partenaire
Content-Type	application/json

L'API envoie automatiquement le code de statut HTTP approprié au client:

• 400 pour les erreurs attendues
• 500 pour les imprévues.

Il fournit également une description de l'erreur dans le format d'erreur Hydra ou dans le format décrit dans le RFC 7807.

Voici un exemple d'une erreur levée lors de la validation incorrecte:

{
    "@context": "/contexts/Error",
    "@type": "Error",
    "hydra:title": "An error occurred",
    "hydra:description": {
        "phone": "The number must be in international format, eg: +33523432342"
    }
}

Réponse

En cas de succés l'API retournera un code HTTP 201 avec le token de l'utilisateur que vous devrez systématiquement transmettre lors de l'appel de notre embed/iframe.

{
    "@context": "/contexts/Professional",
    "@type": "Professional",
    "token": "053e41b0-c19b-4ebd-957a-d517154bec90"
}