Migrer une intégration Yousign existante

WakaSign expose une couche de compatibilité Yousign v3. La migration consiste à changer la base URL et la clé API — le reste du code peut rester inchangé.

Pré-requis communs

Tous les tutoriels partagent le même mécanisme d'authentification.

Chaque appel HTTP doit porter un header Authorization: Bearer <token> où <token> est un token dk_… généré dans l'app WakaSign (menu Clés API & Webhooks). Le token est lié à un workspace (team) — toutes les opérations s'effectuent dans son périmètre.

Base URL : https://app.wakasign.com/api

Étapes de migration

Identifier les appels Yousign à porter

Les endpoints les plus courants supportés tels quels : /v3/signature_requests, /v3/signers, /v3/documents, /v3/webhooks, /v3/contacts, /v3/electronic_seals, /v3/custom_experiences.

Remplacer la base URL et le token

Yousign : https://api.yousign.app/v3

WakaSign : https://app.wakasign.com/api/yousign/v3

Remplace ta clé Yousign par un token WakaSign dk_…. Aucune autre modification de signature ou de payload n'est nécessaire.

Tester en miroir avec curl

bash

# Lister les signature requests existantes
curl -X GET 'https://app.wakasign.com/api/yousign/v3/signature_requests' \
  -H 'Authorization: Bearer dk_xxx'

bash

# Créer une signature request (payload Yousign standard)
curl -X POST 'https://app.wakasign.com/api/yousign/v3/signature_requests' \
  -H 'Authorization: Bearer dk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Contrat de prestation",
    "delivery_mode": "email",
    "ordered_signers": false
  }'

Brancher les webhooks Yousign

Les webhooks suivent la même forme que ceux de Yousign — pointe simplement l'URL /v3/webhooks vers WakaSign et garde ton handler tel quel.

bash

curl -X POST 'https://app.wakasign.com/api/yousign/v3/webhooks' \
  -H 'Authorization: Bearer dk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://app.example.com/webhooks/yousign",
    "events": ["signature_request.done"]
  }'

Vérifier avec le Swagger Yousign

Ouvrir le Swagger Yousign

Toute la surface portée y est documentée avec les payloads attendus et les codes d'erreur compatibles avec le format Yousign ({ type, detail }).