Développeurs
Construisez surl'API Mateflow.
Une clé, une communauté. Lisez les publications, les fils, les espaces et les membres, publiez au nom de vos membres et recevez chaque événement par webhook — le tout depuis une seule API JSON.
Capacités
Tout ce qu'il faut pour intégrer
Clés d'API à portées
Créez des clés dans la console d'administration de votre communauté et n'accordez à chacune que les portées dont elle a besoin. L'authentification passe par l'en-tête X-API-Key : aucune session à gérer.
Growth et au-delà
API JSON
Lisez et écrivez dans votre communauté à travers une seule enveloppe cohérente. Tous les endpoints vivent sous /site_open_api/v1, acceptent un POST avec un corps JSON, et déduisent la communauté de votre clé.
Growth et au-delà
Webhooks
Enregistrez des endpoints pour recevoir les événements dès qu'ils surviennent. Chaque livraison porte un event_id stable qui permet de dédupliquer les tentatives, et ce même id arrive côté Slack, Discord et Zapier.
Growth et au-delà
Intégrations
Connectez Slack, Discord et Zapier depuis le hub d'intégrations, parcourez le catalogue d'applications et gérez tout ce qui est connecté au même endroit.
Authentification unique
Centralisez l'authentification de votre équipe et de vos membres au lieu d'entretenir un second jeu d'identifiants.
Business et au-delà
Journaux de livraison
Chaque tentative de livraison de webhook est journalisée avec son payload et sa réponse. Examinez une livraison échouée, vérifiez ce que vous avez renvoyé, et relancez depuis la console.
Growth et au-delà
24 endpoints, une enveloppe
Tout vit sous https://api.mateflow.com/site_open_api/v1 et utilise POST avec un corps JSON. Voici ceux par lesquels la plupart des intégrations commencent — la liste complète est dans la référence.
- POST/capabilities/getaucune portéeVérifier votre clé, vos portées et le quota restant
- POST/site/getsite.readLire le profil et les réglages de la communauté
- POST/feed/listcontent.readParcourir le fil de la communauté
- POST/post/searchcontent.readRechercher des publications
- POST/post/createcontent.writePublier en tant que membre
- POST/space/listspaces.readLister les espaces visibles pour l'observateur
- POST/member/lookupmembers.readRésoudre une adresse e-mail en membre
- POST/media/get_tokenmedia.writeObtenir un jeton d'envoi de média
Démarrage rapide
Démarrez en trois étapes
Activez l'accès API
L'accès API est une fonctionnalité de forfait que la personne propriétaire de la communauté active. Sans elle, chaque appel renvoie 22203 et aucune clé ne peut être créée — commencez ici, pas dans votre code.
Créez une clé à portées
Administration de la communauté → Intégrations → API Keys. Ne cochez que les portées nécessaires : elles sont figées dès que la clé existe. La clé complète n'est affichée qu'une seule fois.
Appelez d'abord /capabilities/get
Il indique vos portées, si l'accès API est actif et le quota restant — et c'est le seul endpoint qui répond encore quand le forfait ou le quota bloque tout le reste. Il ne consomme pas de quota.
Usage et limites
Ce que chaque forfait autorise
Le quota journalier compte chaque requête qui passe l'authentification et se réinitialise à 00:00 UTC. Un quota de zéro est une porte fermée, pas une valeur non renseignée : il renvoie 22204 à chaque appel.
| Forfait | API ouverte | Requêtes par jour | Endpoints de webhook |
|---|---|---|---|
| Starter | Non inclus | — | — |
| Growth | Inclus | 5,000 | 5 |
| Business | Inclus | 10,000 | 20 |
| Enterprise | Inclus | Illimité | Illimité |
Des limites de rafale s'appliquent en plus du quota journalier, par clé — voir les limites de débit dans la référence.
Votre premier appel, de trois façons
La même requête dans chaque langage : vérifiez que la clé fonctionne avant d'écrire quoi que ce soit d'autre. Remplacez mfk_xxx par une vraie clé de votre console.
curl -X POST \
https://api.mateflow.com/site_open_api/v1/capabilities/get \
-H "X-API-Key: mfk_xxx" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch(
"https://api.mateflow.com/site_open_api/v1/capabilities/get",
{
method: "POST",
headers: {
"X-API-Key": process.env.MATEFLOW_API_KEY,
"Content-Type": "application/json",
},
// Endpoints that take no parameters still want a JSON body.
body: "{}",
},
);
const { code, data } = await res.json();
// Branch on `code`, never on the HTTP status:
// 22203 and 22204 are 403, and only 10202 is throttling.
if (code !== 0) throw new Error(`Mateflow API error ${code}`);
console.log(data.scopes, data.quota_used, data.quota_limit);import os, requests
res = requests.post(
"https://api.mateflow.com/site_open_api/v1/capabilities/get",
headers={"X-API-Key": os.environ["MATEFLOW_API_KEY"]},
json={},
)
body = res.json()
if body["code"] != 0:
raise RuntimeError(f"Mateflow API error {body['code']}")
print(body["data"]["scopes"], body["data"]["api_access"])Contrat OpenAPI
Le contrat lisible par machine couvre chaque chemin et chaque schéma de requête et de réponse, et alimente n'importe quel générateur de clients. Les SDK officiels sont à la feuille de route ; en attendant, générez le vôtre.
Référence
La référence complète de l'API
Portées, pagination, idempotence, codes d'erreur, limites de débit, déduplication des webhooks — et la poignée d'exceptions qui ne mordent qu'une fois en production.
Prêt à construire ?
Créez un compte, générez vos clés d'API et commencez à intégrer Mateflow à vos workflows.
Essai gratuit de 14 jours · Sans carte bancaire