Connecter un outil

Tous les outils se branchent de la même façon : une requête HTTP vers https://<votre-espace>.deltia.co/api/v1/…, avec l'en-tête Authorization: Bearer <secret>. Rangez le secret dans le coffre de l'outil (identifiants, credentials, connexion), jamais en clair dans un scénario partagé.

Postman

Le plus rapide est d'importer le document OpenAPI de votre clé : chaque endpoint et chaque schéma arrivent tout faits.

Téléchargez le document de votre clé :

curl https://acme.deltia.co/api/v1/openapi.json \
  -H "Authorization: Bearer dlt_…" -o deltia-openapi.json

Dans Postman, importez le fichier deltia-openapi.json.
Dans la collection créée, onglet « Authorization », choisissez « Bearer Token » et collez le secret.

Le document ne décrit que ce que cette clé peut faire : une autre clé, avec d'autres accès, produit un autre document.

Make

Utilisez le module « HTTP » › « Make a request » :

URL : https://acme.deltia.co/api/v1/crm/entities/societes/records
Méthode : GET pour lire, POST ou PATCH pour écrire
En-têtes : Authorization = Bearer dlt_…
Pour écrire : « Body type » en « Raw », « Content type » en JSON
Cochez « Parse response »

Pour tout lire, bouclez tant que nextCursor n'est pas null (voir Lire et synchroniser).

n8n

Utilisez le nœud « HTTP Request » avec une authentification « Header Auth » : nom Authorization, valeur Bearer dlt_…. Pour écrire, envoyez le corps en JSON. La pagination du nœud peut suivre nextCursor : paramètre de requête cursor, arrêt quand nextCursor est vide.

Zapier

Utilisez « Webhooks by Zapier » › « Custom Request » : méthode, URL, en-tête Authorization: Bearer dlt_…, et pour écrire un corps JSON avec l'en-tête Content-Type: application/json.

Power BI

Dans « Obtenir les données » › « Web » › « Avancé », indiquez l'URL d'une liste et ajoutez l'en-tête Authorization avec la valeur Bearer dlt_…. À l'enregistrement de la source, choisissez l'authentification « Anonyme » : la clé voyage dans l'en-tête. Une liste dépassant une page demande de suivre nextCursor dans une fonction Power Query.

Ce qui échoue le plus souvent

401 invalid-api-key : le mot Bearer manque, le secret est tronqué, ou la clé est présentée sur l'adresse d'un autre espace.
415 unsupported-media-type : un POST ou un PATCH sans Content-Type: application/json.
429 rate-limited : un scénario qui boucle trop vite ; respectez Retry-After.