Documentation API

API REST HelloWeSign

Integrez la signature electronique dans vos applications et automatisez vos workflows

Demarrage rapide
Commencez a utiliser l'API en 3 etapes
1

Creez un compte

Inscrivez-vous sur HelloWeSign. Le plan gratuit inclut un crédit de 5 signatures.

Creer un compte gratuit
2

Generez votre cle API

Depuis votre dashboard, allez dans "Cles API" et generez une nouvelle cle. Copiez-la et stockez-la en securite.

Important : Ne partagez jamais votre cle API. Stockez-la dans vos variables d'environnement.

3

Faites votre premier appel

Testez l'API en creant votre premiere demande de signature :

curl -X POST https://hellowesign.com/api/v1/signature-requests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documentUrl": "https://example.com/contract.pdf",
    "documentName": "Contrat de prestation",
    "signers": [{
      "name": "Jean Dupont",
      "email": "jean@example.com",
      "signatureZones": [{
        "page": 0,
        "x": 100,
        "y": 500,
        "width": 200,
        "height": 60,
        "boxType": "signature"
      }]
    }]
  }'
Authentification

Toutes les requetes API doivent inclure votre cle API dans l'en-tete Authorization avec le prefixe Bearer.

Authorization: Bearer YOUR_API_KEY

Base URL

https://hellowesign.com/api/v1

Securite : Ne jamais exposer votre cle API cote client. Utilisez-la uniquement depuis votre backend.

Systeme de coordonnees
Comment positionner les zones de signature sur vos PDF

Systeme de coordonnees

  • Origine (0,0) : En haut a gauche de chaque page
  • X : Distance en pixels depuis le bord gauche
  • Y : Distance en pixels depuis le bord haut
  • Page : Index de la page (0 pour la premiere page, 1 pour la deuxieme, etc.)
  • Unite : Toutes les valeurs sont en pixels

Types de zones disponibles

signature

Zone de signature manuscrite

paraph

Zone pour les initiales/paraphe

text

Zone de texte libre

date

Zone pour la date de signature

lu_approuve

Zone "Lu et approuve" pre-remplie

Exemple avec plusieurs zones :

{
  "name": "Jean Dupont",
  "email": "jean@exemple.com",
  "signatureZones": [
    {
      "page": 0,        // Premiere page
      "x": 100,         // 100px depuis la gauche
      "y": 500,         // 500px depuis le haut
      "width": 200,     // Largeur de 200px
      "height": 60,     // Hauteur de 60px
      "boxType": "signature"
    },
    {
      "page": 0,
      "x": 320,
      "y": 500,
      "width": 120,
      "height": 40,
      "boxType": "date"
    },
    {
      "page": 2,        // Troisieme page (paraphe)
      "x": 450,
      "y": 700,
      "width": 80,
      "height": 40,
      "boxType": "paraph"
    }
  ]
}
Endpoints disponibles

Codes de reponse HTTP
200Succes
201Cree avec succes
202En traitement
400Requete invalide
401Non authentifie
402Quota insuffisant
404Non trouve
500Erreur serveur
Support et assistance

Besoin d'aide avec l'API? Notre equipe technique est la pour vous accompagner.

Pret a commencer ?

Creez votre compte gratuit et obtenez votre cle API en 2 minutes