Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Authentification de la Partner API : clés Bearer ec_live_, rotation et erreurs 401

Chaque requête Partner API transporte la clé secrète du compte dans l'en-tête Authorization : Bearer ec_live_…, envoyée depuis votre serveur. Chaque compte easyCoexistence dispose d'une seule clé, créée dans le dashboard sous Profil, Développeurs, ou en demandant à un assistant IA d'exécuter create_api_key, et affichée une seule fois. La rotation émet une nouvelle clé et met fin à l'ancienne aussitôt ; une clé absente ou incorrecte renvoie 401 unauthorized.

ec_live_

Le préfixe par lequel commence chaque clé Partner API, envoyé à chaque requête dans Authorization : Bearer.

1 key

Clés qu'un compte détient à la fois ; chaque connexion créée avec elle appartient à ce compte.

401

Statut pour une clé absente ou invalide, avec le code d'erreur unauthorized et un message nommant l'en-tête attendu.

Once

Moment où la clé complète est affichée, à sa création ou sa rotation ; ensuite, seuls ses premiers caractères sont visibles.

Comment une requête s'authentifie-t-elle ?

Avec la clé sous forme de token Bearer, dans l'en-tête Authorization de chaque requête vers https://easycoexistence.com/api/v1. Rien d'autre n'est signé ni restreint : la clé identifie le compte, et tout ce qu'une requête crée ou lit appartient à ce compte. Les corps sont en JSON, et chaque erreur revient sous forme d'objet avec un code et un message.

List the account's numbers
curl https://easycoexistence.com/api/v1/connections \
  -H "Authorization: Bearer $EC_API_KEY"

Où créer la clé ?

Dans le dashboard ou depuis un assistant IA, avec le même résultat. Dans le dashboard, ouvrez Profil, puis Développeurs, et cliquez sur Créer une clé API. Dans Claude, ChatGPT ou un autre assistant connecté au serveur MCP d'easyCoexistence, demandez-lui de configurer la Partner API : get_partner_setup indique ce qui manque et create_api_key renvoie la clé. Dans les deux cas, la clé complète n'apparaît qu'une fois ; enregistrez-la aussitôt dans les secrets de votre backend.

Pourquoi la clé n'est-elle affichée qu'une fois ?

Parce que seul un hash de la clé est stocké. easyCoexistence conserve ce hash pour vérifier chaque requête, ainsi que les premiers caractères de la clé, ec_live_ et six autres, afin que le dashboard puisse indiquer quelle clé est active et quand elle a été créée. Une clé perdue ne peut plus être affichée ; la rotation la remplace.

Comment effectuer la rotation ou révoquer la clé ?

En une seule étape, et l'ancienne clé cesse de fonctionner à cet instant, sans période de grâce, car une fuite est la raison habituelle d'une rotation. La nouvelle clé s'affiche une fois, comme la première :

  • Dashboard : Profil, Développeurs, Renouveler la clé.
  • MCP : create_api_key avec replace_existing à true. Sans cela, l'outil refuse tant qu'une clé existe, afin qu'une intégration en cours ne soit pas cassée par accident.
  • Pour couper tout accès à la place, révoquez : Révoquer dans le dashboard, ou revoke_api_key avec confirm à true. Les requêtes échouent alors jusqu'à la création d'une nouvelle clé.

Que renvoie une clé absente ou incorrecte ?

Un 401 avec le code unauthorized, pour une requête sans en-tête Authorization, une clé qui ne commence pas par ec_live_, ou une clé qui a été renouvelée ou révoquée. Le message nomme l'en-tête attendu. Lorsque des requêtes échouées continuent de venir d'une même adresse, l'API répond à la place 429 rate_limited, avec le nombre de secondes à attendre avant une nouvelle tentative.

401 Unauthorized
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
  }
}

Qu'est-ce qu'une clé valide peut encore se voir refuser ?

Une clé valide authentifie le compte, et l'état du compte continue de s'appliquer. Ces cas renvoient la même structure d'erreur :

  • 402 billing_required : aucune carte sur le compte pour l'instant, donc aucune session de connexion ne peut démarrer.
  • 404 not_found : l'identifiant n'appartient à aucune connexion, aucun canal ni aucune session de ce compte, y compris ceux d'autres comptes.
  • 409 removed : la connexion a été supprimée, donc son webhook ne peut plus changer.
  • 402 suspended : la connexion est suspendue après un abonnement expiré ; reconnectez-la d'abord.
  • 429 cap_reached ou rate_limited : trop de sessions de connexion ouvertes, ou trop créées dans l'heure.

Erreurs courantes

  • Mettre la clé dans le code front-end. Quiconque ouvre la page peut la lire, créer des connexions facturées à votre compte et récupérer les tokens de vos clients avec ?credentials=1.
  • Renouveler la clé avant que votre backend puisse prendre la nouvelle. L'ancienne clé s'arrête aussitôt, si bien que chaque requête échoue en 401 jusqu'au déploiement de la nouvelle.
  • Créer la clé dans une conversation que vous partagez. create_api_key la renvoie dans le chat, où elle reste dans l'historique ; renouvelez-la si cette conversation est partagée.
  • Enregistrer la clé entre guillemets. Tout ce qui suit Bearer est lu comme la clé, donc une valeur entre guillemets ne correspond jamais et chaque requête reçoit un 401.
Faire cela avec EasyCoexistence

easyCoexistence donne à chaque compte une clé Partner API, pour que votre backend puisse connecter les numéros WhatsApp de vos clients ainsi que leurs comptes Instagram, Facebook, TikTok, YouTube et LinkedIn, et d'autres canaux encore, puis lire les identifiants de chaque connexion et router ses événements. De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Un compte peut-il avoir plusieurs clés API ?

Non. Un compte n'a qu'une clé à la fois, et en créer une nouvelle remplace l'ancienne. Des clés distinctes correspondent à des comptes easyCoexistence distincts, chacun avec ses propres connexions et sa propre facturation.

Les clés Partner API expirent-elles ?

Non. Une clé fonctionne jusqu'à sa rotation ou sa révocation, ou jusqu'à ce qu'easyCoexistence y mette fin pour abus des règles de Meta.

Mes clients ont-ils besoin de ma clé pour se connecter ?

Non. Ils ouvrent seulement le lien de connexion hébergé, qui porte son propre identifiant de session. La clé reste sur votre serveur et n'est utilisée que par votre backend.

La clé API est-elle la même que le secret de signature des événements ?

Non. La clé authentifie vos requêtes vers l'API. Le secret de signature, affiché une fois lorsque vous définissez une URL d'événements de statut, permet à votre endpoint de vérifier les événements qu'easyCoexistence envoie.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le