2 juin 2026Support client

Se connecter à l’API initdesk en 15 minutes

L’API initdesk est en ligne : émettez un jeton, trouvez l’ID d’organisation, et listez des tickets avec curl en une seule séance.

L’API initdesk est disponible aujourd’hui sur developers.initdesk.com, avec les requêtes envoyées à https://api.initdesk.com.

Si vous ne savez pas encore si vous avez besoin de l’API, des webhooks ou de BYOD, lisez d’abord API, webhooks ou BYOD. Ce billet suppose que vous voulez que votre code appelle initdesk (créer ou lire tickets, demandeurs, messages, ou contenu du Centre d’aide).

Voici le plus petit chemin vers un appel qui marche : jeton, ID d’organisation, un curl, puis le schéma OpenAPI pour le reste.

Ce dont vous avez besoin avant de commencer

Un compte initdesk où vous êtes Account Owner ou Admin (seuls ces rôles peuvent émettre des jetons API).
L’ID numérique d’organisation depuis Paramètres → Général. Les chemins API utilisent ce nombre, pas le public_id en chaîne de l’organisation dans les URL produit.
Un endroit pour stocker le jeton en sécurité. initdesk stocke un hash côté serveur ; vous voyez le jeton brut une seule fois à la création.

Émettre un jeton d’organisation

Ouvrez Paramètres → Accès API.
Générez un nouveau jeton d’intégration scopé à l’organisation.
Copiez immédiatement le jeton dans votre gestionnaire de secrets ou coffre-fort.

Envoyez-le sur chaque requête avec l’en-tête personnalisé :

X-Initdesk-Token: YOUR_TOKEN_HERE

Ce jeton ne peut accéder qu’aux ressources de l’organisation pour laquelle il a été émis. Les appels vers les URL d’une autre organisation renvoient 403 Forbidden. Les jetons invalides ou révoqués renvoient 401 ou 403 selon le cas. Révoquez les jetons compromis dans le même écran de paramètres.

Détails : Authentication and limits.

Votre première requête : confirmer l’organisation

Remplacez ORG_ID et YOUR_TOKEN dans les exemples ci-dessous.

curl -sS \
  -H "X-Initdesk-Token: YOUR_TOKEN" \
  "https://api.initdesk.com/organizations/ORG_ID/"

Une réponse réussie confirme que vous êtes sur le bon tenant et montre la configuration d’organisation qui peut affecter le comportement des tickets (par exemple si le tagging automatique est activé). Si vous obtenez 401 ou 403, revérifiez le jeton et que ORG_ID correspond à Paramètres → Général.

Lister les boîtes de réception (nécessaire avant de créer des tickets)

Les tickets sont créés dans une boîte de réception précise. Listez-les pour copier un id de boîte pour les futurs appels POST :

curl -sS \
  -H "X-Initdesk-Token: YOUR_TOKEN" \
  "https://api.initdesk.com/organizations/ORG_ID/inboxes/"

Les endpoints de liste renvoient du JSON paginé : count, next, previous et results (taille de page par défaut 20). Suivez les URL next jusqu’à avoir ce qu’il vous faut.

Lister les tickets (chemin en lecture)

curl -sS \
  -H "X-Initdesk-Token: YOUR_TOKEN" \
  "https://api.initdesk.com/organizations/ORG_ID/tickets/"

Par défaut, les tickets spam sont exclus. Pour travailler avec le spam, passez is_spam=true. Filtrez par demandeur avec customer_id quand vous connaissez l’id API du client.

Pour la recherche et les filtres prédéfinis, utilisez l’endpoint search tickets documenté dans l’index de référence API, pratique pour des tableaux de bord ops sans exporter toute votre boîte.

`id` vs `public_id` du ticket (et où vivent les messages)

Chaque ticket a deux identifiants :

Champ	Usage
`id`	Clé primaire dans les URL API (`/tickets/{id}/`, `/tickets/{id}/messages/`)
`public_id`	Numéro côté humain dans les sujets d’e-mail et l’UI (« Ticket #1234 »)

Utilisez toujours id dans les appels API. Montrez public_id aux clients quand vous avez besoin du libellé familier.

La ligne ticket est le conteneur (sujet, statut, responsable, boîte, étiquettes). Le fil (réponses, notes internes, événements système) est dans les messages :

/organizations/{organization_id}/tickets/{ticket_id}/messages/

Récupérez un ticket pour les métadonnées ; listez les messages quand vous avez besoin de toute la conversation. Le comportement au niveau des champs est dans Entities and relationships.

OpenAPI, pagination et limites de débit

Schéma OpenAPI : https://api.initdesk.com/schema.yaml : générez des clients ou explorez chaque chemin sous /organizations/{organization_id}/.
Pagination : listes par numéro de page avec count, next, previous, results.
Limites de débit : 60 requêtes par minute par jeton pour la plupart des endpoints. La création de tickets est aussi limitée par organisation à l’heure. Sur 429 Too Many Requests, reculez avec un délai exponentiel et réessayez.

Créer des tickets, répondre, synchroniser des articles du Centre d’aide et gérer des clients sont tous documentés dans la référence développeur. Ce billet s’arrête à lecture/liste pour que vous vérifiiez l’auth avant d’écrire des données.

Questions sur les endpoints bêta ou l’accès : support@initdesk.com.

initdesk est un help desk IA pour les petites équipes. L’API a été lancée aujourd’hui aux côtés de developers.initdesk.com. Plus sur Mises à jour produit et X @initdeskhq.