Comment s'authentifier aux API plezi

Pour toutes vos requêtes API, il vous faudra vous authentifier ! Voici un exemple complet de type CURL d'une entête de requête valide.

Charles Dolisy avatar
Écrit par Charles Dolisy
Mis à jour il y a plus d’une semaine

Toutes vos requêtes API doivent comporter une entête contenant votre identifiant de client, ainsi que votre Token fourni par Plezi.

Vous pouvez retrouver ces informations dans Configuration > Configuration de Plezi

Par défaut, votre compte API n'est pas activé. si jamais vous voyez ce message :

Il vous suffit simplement de cliquer sur le lien en bleu pour l'activer instantanément, ce qui laissera place à une information de ce type :

Il vous suffira de reprendre ces informations personnelles afin de l'insérer dans vos entêtes API sous la forme suivante

X-Tenant-Company: VotreIdentifiant
X-API-Key: 123456789ABCDEFghijkl

Voici un exemple complet de type CURL d'une entête de requête valide :

curl "https://app.plezi.co/api/v1" -X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Tenant-Company: VotreIdentifiant" \
-H "X-API-Key: 123456789ABCDEFghijkl"

Ce qui devrait vous donner une réponse valide ( status: 200 ) de ce type :

{
  "data": {
    "id": "55fc37327a2850ca46000206",
    "type": "tenants",
    "attributes": {
      "created_at": "2015-09-18T18:09:22+02:00",
      "updated_at": "2015-09-18T18:09:22+02:00",
      "company": "Schimmel-Harber",
      "name": "Schimmel-Harber",
      "domain": "schimmel-harber.pages.app.plezi.co",
      "locale": null,
      "time_zone": "Paris"
    }
  }
}


Si jamais votre requête n'était pas correcte, vous devriez voir une réponse au status 401 dont le message serait clairement énoncé, vous pouvez vous reporter à la documentation technique des API pour le détail.

Avez-vous trouvé la réponse à votre question ?