Identifiants de requête

Chaque réponse de l’API, erreurs comprises, porte un en-tête Request-Id : req_ suivi de 26 caractères. Une erreur le reprend aussi dans son corps, sous le nom request_id :

{
  "error": {
    "type": "invalid_request_error",
    "code": "resource_missing",
    "message": "No such event: 'EVT-5a1f0c2e-3b7d-4e91-9c2a-1d6e8f4b7a30'.",
    "param": "id",
    "doc_url": "https://developer.masterconf.com/errors/codes#resource_missing",
    "request_id": "req_01JAZ5Q3X8M4K2N7P9R6T0V1W3"
  }
}

Journalisez-le

Gardez le Request-Id dans vos journaux avec chaque appel, au moins pour ceux qui échouent. C’est le moyen le plus rapide de retrouver une requête du côté de la plateforme.

Communiquez-le au support

Quand vous contactez le support au sujet d’un appel, donnez :

• son Request-Id ;
• l’heure de l’appel ;
• l’id de la clé utilisée. GET/v1/account le donne dans api_key.id.

N’envoyez jamais la clé elle-même : le support n’en a jamais besoin.

Quand il n’y en a pas

Une 429 renvoyée par la limite de débit de la passerelle a un request_id à null : la requête n’a jamais atteint l’API. Voir Limites de débit.