Sandbox

Comment activer la sandbox ?

Depuis votre organisation, ouvrez la section Applications externes et créez une application en environnement sandbox. La clé API émise est strictement scopée à la sandbox — elle ne peut signer aucun document de production.

Vous appelez la même URL qu'en production (https://app.signlift.eu/api/v1) ; l'environnement est conditionné par la clé envoyée. Voir Authentification pour la mécanique sandbox / production.

Récupérer l'OTP sandbox dans la réponse

Pour permettre des tests end-to-end automatisés (Playwright, Cypress, etc.), Signlift expose le code OTP dans la réponse de l'endpoint d'envoi d'OTP uniquement en sandbox. Le code reste aléatoire à chaque envoi — il n'est pas fixe.

<token> ci-dessous est le segment final de signing_url (tout ce qui suit /sign/) — vous l'extrayez du signing_url retourné par l'API.

curl -X POST https://app.signlift.eu/sign/<token>/otp \
  -H "Content-Type: application/json" \
  -d '{"channel":"email"}'

{
  "message": "Code envoyé.",
  "channel": "email",
  "sandbox_code": "489152"
}

En production, le champ sandbox_code est absent de la réponse (l'OTP n'est connu que du signataire, via e-mail ou SMS). Sa présence est donc un indicateur fiable que vous travaillez bien en sandbox.

// Test E2E Playwright en sandbox
const token = signingUrl.split("/sign/")[1]
const res = await fetch(`https://app.signlift.eu/sign/${token}/otp`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ channel: "email" }),
})
const { sandbox_code } = await res.json()
await page.fill('input[name="otp"]', sandbox_code)

Filigrane sur les documents signés

Tout document signé via une clé sandbox porte un filigrane visible sur chaque page (SANDBOX — non opposable ou équivalent). C'est un garde-fou visuel : un document sandbox ne peut être confondu avec un document de production.

Webhooks en local

Pour recevoir les webhooks sur localhost, exposez votre serveur via ngrok, Cloudflare Tunnel ou similaire :

ngrok http 3000
# Forwarding https://abc123.ngrok.app -> http://localhost:3000

Configurez l'URL ngrok comme webhook_url de votre application externe sandbox dans le dashboard.

Rate-limits et quotas

Les rate-limits et quotas mensuels s'appliquent identiquement en sandbox et en production, en fonction du plan de votre organisation. Voir Limites et rate-limits.