Intégrations · API REST et webhooks

Chaque bouton du tableau de bord, en point de terminaison

Une API REST versionnée et 191 événements webhook signés, derrière des jetons dont vous choisissez la portée, sur tous les forfaits

Tout ce que le tableau de bord peut faire, le code peut le faire : 40 familles de ressources sur une API versionnée décrite par une spécification OpenAPI publiée, des jetons d'accès personnels qui ne portent que les permissions que vous cochez, des écritures qui acceptent une clé d'idempotence pour qu'une nouvelle tentative ne duplique jamais, et 191 événements envoyés à vos points de terminaison avec une signature HMAC et une échelle de nouvelles tentatives qui insiste pendant environ 4 jours. Le point de terminaison REST et l'outil MCP d'une opération partagent la même action en dessous, si bien qu'un agent, un Zap et votre propre service font tous exactement ce que ferait le tableau de bord.

Surface
40 familles de ressources
Projets, forfaits, pass, abonnements, membres, coupons, codes d'accès, diffusions, support, connecteurs, reprise et plus, sur un chemin versionné avec une spécification OpenAPI publiée.
Jetons
130 permissions à portée limitée
Un jeton d'accès personnel ne porte que les permissions que vous cochez ; les jetons de production et de test se distinguent par leur préfixe et sont refusés dans le mauvais environnement.
Limites
300 par minute, 10,000 par heure, par jeton
Plus des quotas plus stricts sur quelques points de terminaison lourds ; chaque réponse dit ce qu'il reste et une requête limitée dit quand réessayer.
Webhooks
191 événements signés
HMAC-SHA256 sur l'horodatage et le corps, un journal des livraisons, et 8 tentatives sur environ 4 jours quand votre point de terminaison est hors ligne.
Idempotence
Répétitions servies pendant 24 heures
Envoyez une clé d'idempotence avec une écriture et une relance renvoie la première réponse au lieu d'un second enregistrement.
Inclus dans
Tous les forfaits, Free compris
L'API, les webhooks, la spécification OpenAPI et le serveur MCP ne coûtent rien de plus, quel que soit le forfait.

Ce que l'API vous donne

Une spécification, n'importe quel outillage

Le document OpenAPI s'importe dans Postman ou Insomnia pour explorer, dans un générateur de code pour un client typé, et dans une boîte à outils LangChain pour un agent, sans client écrit à la main.

Le moindre privilège, par permission

Les jetons portent des permissions, pas des rôles : un service de reporting détient les lectures dont il a besoin et rien d'autre, un service de paiement détient une seule écriture, et renouveler un jeton arrête tout ce qui l'utilisait.

Des événements fiables

Chaque webhook est signé, retenté sur une échelle qui s'élargit et journalisé à chaque tentative ; les corps de messages des événements de support restent hors de la charge utile, récupérés via l'API quand vous en avez besoin.

Conçu en pensant aux agents

Le point de terminaison REST et l'outil MCP d'une même opération partagent une seule action, les codes d'erreur forment un catalogue lisible, et les tâches asynchrones rapportent leur progression, si bien qu'une machine peut piloter la plateforme aussi sûrement qu'une personne.

Comment commencer

  1. 1

    Créez un jeton d'accès personnel sous Paramètres, Jetons d’API, en ne cochant que les permissions dont vous avez besoin ; utilisez d'abord un jeton de test sur un projet de test.

  2. 2

    Importez la spécification OpenAPI dans Postman ou Insomnia, ou générez-en un client typé, et faites votre première lecture.

  3. 3

    Ajoutez un en-tête de clé d'idempotence à chaque écriture, pour qu'une nouvelle tentative après un délai dépassé renvoie la première réponse.

  4. 4

    Ajoutez un point de terminaison webhook, choisissez les événements, conservez le secret, et vérifiez la signature de chaque livraison avant d'agir.

  5. 5

    Surveillez le journal des livraisons et les en-têtes de limite de débit, et lisez la page de versionnage avant de bâtir sur quoi que ce soit marqué comme changeant.

Lire le guide

Idéal pour

  • Les développeurs qui construisent un paiement, une synchronisation CRM ou un service de reporting
  • Les agences qui gèrent de nombreuses communautés depuis un seul système
  • Quiconque veut que la plateforme s'adapte à sa pile technique plutôt que l'inverse

Questions fréquentes

Lire le guide
L'API est-elle sur le forfait Free ?
Oui. L'API, les webhooks, la spécification OpenAPI et le serveur MCP sont sur tous les forfaits, Free compris, avec les mêmes limites.
Comment la portée des jetons est-elle définie ?
Par permission, parmi 130 : vous cochez ce qu'un jeton peut faire à sa création, et une requête hors de cette liste est refusée avec une erreur claire. Les jetons de production et de test portent des préfixes différents et sont refusés dans le mauvais environnement.
Quelles sont les limites de débit ?
300 requêtes par minute et 10,000 par heure par jeton, avec des quotas plus stricts sur quelques points de terminaison lourds comme la génération de codes en masse ; les en-têtes de réponse disent ce qu'il reste et une requête limitée dit quand réessayer.
Que se passe-t-il quand mon point de terminaison webhook est hors ligne ?
Subscriby relance la livraison jusqu'à 8 fois sur environ 4 jours selon une échelle croissante, journalise chaque tentative et marque la livraison dès que votre point de terminaison répond par un succès. Les livraisons ne sont pas strictement ordonnées en cas de relance, agissez donc sur les données de l'événement plutôt que sur son ordre d'arrivée.
Comment éviter les doublons en cas de relance ?
Envoyez une clé d'idempotence avec chaque écriture. Une répétition avec la même clé dans les 24 heures renvoie la réponse reçue par la première tentative, donc une requête relancée ne crée jamais un second code, coupon ou réponse.

Commencez gratuitement — Lisez la spécification, faites le premier appel

Free Plan includes 3 projects. No monthly fee — card on file required to charge transaction fees.

Installation gratuite en 30 minutes
Nos feuilles de route