REPOS API
Les appels de serveur à serveur utilisent `Authorization: Bearer esk_test_…` ou `esk_live_…`. Le locataire vient de la clé. Le téléchargement, l''assistant d''enveloppe et l''enregistrement webhook utilisent la session d''administration.
Qu''est-ce qu''une clé API de locataire peut appeler
| Appeler | Portée sur la clé | Ce que vous récupérez |
|---|---|---|
| GET /api/v1/zapier/auth/test | integrations:zapier | Votre identifiant et nom de locataire. Utilisez-le pour confirmer la clé. |
| GET /api/v1/zapier/triggers/{event}/sample | integrations:zapier | Exemples de charges utiles pour document.signed, document.completed, document.expired et template.created. |
| POST /api/v1/zapier/actions/create-from-template | integrations:zapier | Un nouvel identifiant de document à partir d''un modèle que vous possédez déjà. |
| POST /api/v1/zapier/actions/send-for-signing | integrations:zapier | Le document passe au lien envoyé et le signataire reçoit un e-mail. |
| POST /api/v1/signing-sessions/{sessionId}/tokens | signing:write | Un jeton st_… de courte durée pour l''intégration. Le navigateur utilise ce jeton, pas la clé API. |
Session d''administration
Connectez-vous à l''application d''administration pour ceux-ci. Une clé au porteur API sur ces itinéraires est refusée.
| Travail | Où |
|---|---|
| Télécharger un PDF, des clients, des modèles | Documents administratifs et clients |
| Assistant d''enveloppe : créer, envoyer, annuler | Enveloppes admin |
| Enregistrez, faites pivoter et rejouez les webhook | Administrateur → Développeur → Webhooks |
Confirmez la clé, puis envoyez un modèle de document
Prérequis : une clé `esk_test_…` ou `esk_live_…` avec `integrations:zapier` et un identifiant de modèle. Résultat attendu : HTTP 200 du test d''authentification, HTTP 201 avec `documentId`, puis `status : "link-sent"`.
curl -sS https://api.endorsedsign.com/api/v1/zapier/auth/test \
-H "Authorization: Bearer $ENDORSED_API_KEY"
curl -sS -X POST https://api.endorsedsign.com/api/v1/zapier/actions/create-from-template \
-H "Authorization: Bearer $ENDORSED_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"templateId": "'"$ENDORSED_TEMPLATE_ID"'",
"recipientEmail": "signer@example.com",
"recipientName": "Signer Example"
}'
curl -sS -X POST https://api.endorsedsign.com/api/v1/zapier/actions/send-for-signing \
-H "Authorization: Bearer $ENDORSED_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"documentId": "'"$ENDORSED_DOCUMENT_ID"'",
"channel": "email"
}'Les nouvelles intégrations doivent appeler `/api/v1/…` ou `/api/v2/…`. `/api/v2` est le contrat du 01/09/2026. Les appels mutants qui le prennent en charge doivent envoyer « Idempotency-Key ».
Questions courantes
API dans l''espace de travail du développeur locataire
Créez une clé nommée, attribuez des étendues et consultez le préfixe dans le même chrome d''administration que vos opérateurs utilisent déjà. Clés
SDK démarrages rapides à côté des informations d''identification actives
Les opérateurs peuvent faire pivoter les clés et transférer l''intégration SDK spécifique à la langue à partir du même espace de travail de développeur locataire. Démarrages rapides
Espace de travail développeur avec données en direct
Une surface de développeur unique affichant les contrôles clés du locataire actif API dans l''espace de travail d''administration.
Obtenez votre clé API en un seul appel
POST /api/auth/register with `mode: sandbox` returns an `esk_test_` key. Confirm it with GET /api/v1/zapier/auth/test. OpenAPI is at /api/docs.json on an API host that has docs enabled.