Partner API-authenticatie: Bearer ec_live_-sleutels, rotatie en 401-fouten
Elk Partner API-verzoek draagt de geheime sleutel van het account in de header Authorization: Bearer ec_live_…, verzonden vanaf je server. Elk easyCoexistence-account heeft één sleutel, aangemaakt in het dashboard onder Profiel, Developers, of door een AI-assistent create_api_key te laten uitvoeren, en slechts één keer getoond. Roteren geeft een nieuwe sleutel en beëindigt de oude direct; een ontbrekende of foute sleutel geeft 401 unauthorized.
Het voorvoegsel waarmee elke Partner API-sleutel begint, bij elk verzoek verzonden als Authorization: Bearer.
Het aantal sleutels dat een account tegelijk bezit; elke verbinding die ermee is gemaakt, hoort bij dat account.
Status bij een ontbrekende of ongeldige sleutel, met de foutcode unauthorized en een bericht dat de verwachte header noemt.
Hoe vaak de volledige sleutel wordt getoond: bij aanmaken of roteren; daarna zijn alleen de eerste tekens zichtbaar.
Hoe authenticeert een verzoek zich?
Met de sleutel als Bearer-token in de Authorization-header van elk verzoek naar https://easycoexistence.com/api/v1. Er wordt niets anders ondertekend of afgebakend: de sleutel identificeert het account, en alles wat een verzoek aanmaakt of leest, hoort bij dat account. De body van elk verzoek is JSON, en elke fout komt terug als object met een code en een bericht.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Waar maak je de sleutel aan?
In het dashboard of via een AI-assistent, met hetzelfde resultaat. In het dashboard open je Profiel, dan Developers, en klik je op Maak API-sleutel aan. In Claude, ChatGPT of een andere assistent die verbonden is met de MCP-server van easyCoexistence, vraag je die de Partner API in te stellen: get_partner_setup toont wat ontbreekt en create_api_key geeft de sleutel terug. In beide gevallen verschijnt de volledige sleutel één keer, dus sla hem meteen op in de secrets van je backend.
Waarom wordt de sleutel maar één keer getoond?
Omdat alleen een hash ervan wordt opgeslagen. easyCoexistence bewaart de hash om elk verzoek te controleren, plus de eerste tekens van de sleutel, ec_live_ en zes andere, zodat het dashboard kan tonen welke sleutel actief is en wanneer die is gemaakt. Een verloren sleutel kan niet opnieuw getoond worden; roteren vervangt hem.
Hoe roteer of trek je de sleutel in?
In één stap, en de oude sleutel stopt op dat moment, zonder overgangsperiode, want een lek is de gebruikelijke reden om te roteren. De nieuwe sleutel wordt eenmaal getoond, zoals de eerste:
- Dashboard: Profiel, Developers, Sleutel roteren.
- MCP:
create_api_keymetreplace_existingop true. Zonder dat weigert de tool zolang er een sleutel bestaat, zodat een lopende integratie niet per ongeluk breekt. - Om in plaats daarvan alle toegang te stoppen, trek je de sleutel in: Intrekken in het dashboard, of
revoke_api_keymet confirm op true. Verzoeken mislukken dan tot er een nieuwe sleutel is gemaakt.
Wat geeft een ontbrekende of foute sleutel terug?
Een 401 met de code unauthorized, voor een verzoek zonder Authorization-header, een sleutel die niet begint met ec_live_, of een sleutel die is geroteerd of ingetrokken. Het bericht noemt de header die het verwacht. Als mislukte verzoeken blijven komen van één adres, antwoordt de API in plaats daarvan met 429 rate_limited, met de seconden die je moet wachten voor een nieuwe poging.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Waarom kan een geldige sleutel toch geweigerd worden?
Een geldige sleutel authenticeert het account, en de status van het account blijft gelden. Deze antwoorden komen terug met dezelfde foutvorm:
- 402
billing_required: er staat nog geen kaart op het account, dus er kunnen geen connect-sessies worden gestart. - 404
not_found: het id hoort bij geen enkele verbinding, kanaal of sessie van dit account, ook niet bij die van andere accounts. - 409 removed: de verbinding is verwijderd, dus de webhook kan niet meer worden gewijzigd.
- 402 suspended: de verbinding is geschorst na een verlopen abonnement; verbind haar eerst opnieuw.
- 429
cap_reachedofrate_limited: te veel open connect-sessies, of te veel aangemaakt binnen het uur.
Veelgemaakte fouten
- De sleutel in frontend-code zetten. Iedereen die de pagina opent kan hem lezen, verbindingen aanmaken die op jouw rekening gaan en de tokens van je klanten ophalen met ?credentials=1.
- Roteren voordat je backend de nieuwe sleutel kan gebruiken. De oude sleutel stopt meteen, dus elk verzoek mislukt met 401 tot de nieuwe is uitgerold.
- De sleutel aanmaken in een gesprek dat je deelt. create_api_key geeft hem terug in de chat, waar hij in de geschiedenis blijft staan, dus roteer hem als dat gesprek gedeeld is.
- De sleutel opslaan tussen aanhalingstekens. Alles na Bearer wordt als sleutel gelezen, dus een waarde tussen aanhalingstekens komt nooit overeen en elk verzoek krijgt 401.
easyCoexistence geeft elk account één Partner API-sleutel, zodat je backend de WhatsApp-nummers van je klanten en hun Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts kan verbinden, en er komen steeds meer kanalen bij. Daarna kan je de inloggegevens van elke verbinding lezen en de events ervan routeren. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan een account meer dan één API-sleutel hebben?
Nee. Een account heeft tegelijk één sleutel, en een nieuwe maken vervangt die. Aparte sleutels betekenen aparte easyCoexistence-accounts, elk met eigen verbindingen en eigen factuur.
Verlopen Partner API-sleutels?
Nee. Een sleutel werkt tot hij wordt geroteerd of ingetrokken, of tot easyCoexistence hem beëindigt wegens misbruik van de regels van Meta.
Hebben mijn klanten mijn sleutel nodig om te verbinden?
Nee. Zij openen alleen de gehoste connect-link, die een eigen sessie-id bevat. De sleutel blijft op je server en wordt alleen door je backend gebruikt.
Is de API-sleutel hetzelfde als het ondertekeningsgeheim van de events?
Nee. De sleutel authenticeert je verzoeken aan de API. Het ondertekeningsgeheim, eenmaal getoond wanneer je een URL voor statusevents instelt, laat je endpoint de events van easyCoexistence verifiëren.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op