Vue d'ensemble

URLs de base, format des erreurs, rate limits et conventions de l'API Signlift v1.

URLs de base

Environnement	Base URL
Production	`https://api.signlift.io/api/v1`
Sandbox	`https://api-sandbox.signlift.io/api/v1`

Toutes les ressources sont versionnées sous /api/v1. Une future v2 sera servie sous /api/v2 en parallèle ; pas de breaking change sur v1 sans préavis 90 jours.

Authentification

Toutes les requêtes nécessitent un header X-Api-Key. Voir Authentification.

Format des erreurs

Toutes les erreurs suivent ce schéma :

{
  "error": {
    "code": "invalid_argument",
    "message": "validity_days must be between 1 and 90",
    "details": { "field": "validity_days", "value": 365 }
  }
}

HTTP	Code	Signification
400	`invalid_argument`	Payload mal formé.
401	`invalid_api_key`	Clé absente ou révoquée.
403	`forbidden`	Pas les droits sur cette ressource.
404	`not_found`	ID inexistant ou inaccessible.
409	`conflict`	Conflit logique (déjà signé, etc.).
422	`validation_failed`	Échec de validation métier.
429	`rate_limit_exceeded`	Cf. headers `Retry-After`.
500	`internal_error`	Erreur côté Signlift, ré-essayer.

Rate limits

Plan	Requêtes / minute
Free	60
Starter	300
Pro	1 200
Enterprise	Sur mesure

Headers retournés :

X-RateLimit-Limit : limite actuelle
X-RateLimit-Remaining : appels restants dans la fenêtre
X-RateLimit-Reset : timestamp UNIX du reset
Retry-After (en cas de 429) : secondes à attendre

Idempotence

Sur les POST critiques (/signature_requests), passez un header Idempotency-Key: <uuid> pour rendre la requête rejouable sans créer de doublon.

Format de date

Toutes les dates sont ISO 8601 en UTC (2026-05-16T15:00:00Z). Les champs suffixés _at sont des timestamps datetime ; les champs _date sont des dates seules (2026-05-16).