Aller au contenu
UnisoftDocumentation développeur

REST API / v1

Authentification

Une clé, un périmètre et des permissions explicites.

Environnement de cette documentation · Productionhttps://api.unisoft.world/integrations/v1

Transmettez votre clé dans Authorization: Bearer ou X-API-Key. Ne la placez jamais dans une URL ni dans le code public d’un site.

Authorization: Bearer ke_live_REPLACE_WITH_YOUR_KEY

Une clé ke_live_ est rattachée à une seule organisation. Les permissions de lecture, d’écriture et d’envoi sont distinctes. Chaque opération indique les permissions acceptées.

Comprendre une erreur

401 MISSING_API_KEY ou INVALID_API_KEY : vérifiez la clé, l’en-tête et l’environnement. 403 INSUFFICIENT_SCOPE : vérifiez les permissions requises par l’opération.

Les autres erreurs métier sont décrites par opération. Conservez le code HTTP et le champ error pour diagnostiquer un échec.

Après un délai d’attente sur une écriture ou un envoi, vérifiez le résultat avant de réessayer : toutes les opérations ne sont pas idempotentes.

La référence détaillée est disponible en français et en anglais. Les noms des routes, des champs et des valeurs techniques restent inchangés.