Documentation de l'API

Créez une clé sur la page développeurs. Envoyez-la comme jeton bearer. Les exemples utilisent les mêmes routes que le fichier OpenAPI.

Envoyez un PDF, recueillez des signatures vérifiées et téléchargez le fichier scellé. Le tampon visuel reste gratuit dans le navigateur.

Envoyez la clé dans Authorization: Bearer gk_live_... Créer la clé. JSON OpenAPI

cURL

curl -X POST https://gustkit.com/api/v1/envelopes \
  -H "Authorization: Bearer gk_live_..." \
  -H "Idempotency-Key: envelope-42" \
  -H "Content-Type: application/json" \
  -d '{"pdfBase64":"<base64>","ownerName":"Rui","signers":[{"email":"[email protected]","name":"Ana","role":"client"}],"copies":["[email protected]"],"order":"sequential","fields":[{"signer":0,"page":1,"x":0.55,"y":0.8,"w":0.32,"h":0.08,"kind":"signature"}],"lang":"fr"}'

JavaScript

const res = await fetch("https://gustkit.com/api/v1/envelopes", {
  method: "POST",
  headers: {
    Authorization: "Bearer gk_live_...",
    "Content-Type": "application/json",
    "Idempotency-Key": "envelope-42",
  },
  body: JSON.stringify({
    pdfBase64,
    signers: [{ email: "[email protected]", name: "Ana", role: "client" }],
    copies: ["[email protected]"],
    order: "parallel",
    fields: [{ signer: 0, page: 1, x: 0.55, y: 0.8, w: 0.32, h: 0.08, kind: "signature" }],
    lang: "fr",
  }),
});
const envelope = await res.json();

Python

import requests
res = requests.post(
    "https://gustkit.com/api/v1/envelopes",
    headers={"Authorization": "Bearer gk_live_...", "Idempotency-Key": "envelope-42"},
    json={"pdfBase64": pdf_b64, "signers": [{"email": "[email protected]", "name": "Ana"}], "copies": ["[email protected]"], "order": "parallel", "lang": "fr"},
)
print(res.status_code, res.json())

Erreurs

Les erreurs sont du JSON: error.code et error.message. 401 veut dire que la clé manque ou est révoquée. 402 veut dire que le quota gratuit est épuisé alors que la facturation est active. 409 est un conflit, y compris une clé d'idempotence réutilisée avec un autre corps. 429 est la limite par minute de la clé.