Partner-API-Authentifizierung: Bearer-Schlüssel ec_live_, Rotation und 401-Fehler
Jede Partner-API-Anfrage trägt den geheimen Schlüssel des Kontos im Header Authorization: Bearer ec_live_…, gesendet von Ihrem Server. Jedes easyCoexistence-Konto hat genau einen Schlüssel, der im Dashboard unter Profil, Entwickler erstellt wird oder indem Sie einen KI-Assistenten bitten, create_api_key auszuführen. Er wird nur einmal angezeigt. Beim Rotieren wird ein neuer Schlüssel ausgegeben und der alte sofort beendet; fehlt der Schlüssel oder ist er falsch, kommt 401 unauthorized zurück.
Das Präfix, mit dem jeder Partner-API-Schlüssel beginnt, wird bei jeder Anfrage als Authorization: Bearer gesendet.
Schlüssel, die ein Konto gleichzeitig hält; jede damit erstellte Verbindung gehört zu diesem Konto.
Status bei fehlendem oder ungültigem Schlüssel, mit dem Fehlercode unauthorized und einer Meldung, die den erwarteten Header nennt.
Zeitpunkt, zu dem der vollständige Schlüssel angezeigt wird: bei Erstellung oder Rotation; danach sind nur noch seine ersten Zeichen sichtbar.
Wie authentifiziert sich eine Anfrage?
Mit dem Schlüssel als Bearer-Token im Header Authorization jeder Anfrage an https://easycoexistence.com/api/v1. Weitere Signaturen oder Bereichsbeschränkungen gibt es nicht: Der Schlüssel identifiziert das Konto, und alles, was eine Anfrage erstellt oder liest, gehört zu diesem Konto. Die Body-Inhalte sind JSON, und jeder Fehler kommt als Objekt mit einem code und einer message zurück.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Wo erstellen Sie den Schlüssel?
Im Dashboard oder über einen KI-Assistenten, mit demselben Ergebnis. Im Dashboard öffnen Sie Profil, dann Entwickler, und klicken auf API-Schlüssel erstellen. In Claude, ChatGPT oder einem anderen Assistenten, der mit dem MCP-Server von easyCoexistence verbunden ist, bitten Sie ihn, die Partner API einzurichten: get_partner_setup zeigt, was fehlt, und create_api_key gibt den Schlüssel zurück. In beiden Fällen erscheint der vollständige Schlüssel nur einmal, speichern Sie ihn deshalb sofort in den Secrets Ihres Backends.
Warum wird der Schlüssel nur einmal angezeigt?
Weil nur ein Hash davon gespeichert wird. easyCoexistence bewahrt den Hash auf, um jede Anfrage zu prüfen, dazu die ersten Zeichen des Schlüssels, ec_live_ und sechs weitere, damit das Dashboard anzeigen kann, welcher Schlüssel aktiv ist und wann er erstellt wurde. Ein verlorener Schlüssel kann nicht erneut angezeigt werden; eine Rotation ersetzt ihn.
Wie rotieren oder widerrufen Sie den Schlüssel?
In einem Schritt. Der alte Schlüssel funktioniert genau in diesem Moment nicht mehr, ohne Schonfrist, da ein Leck der häufigste Grund für eine Rotation ist. Der neue Schlüssel wird wie der erste nur einmal angezeigt:
- Dashboard: Profil, Entwickler, Schlüssel rotieren.
- MCP:
create_api_keymitreplace_existingauf true. Ohne diesen Parameter verweigert das Tool die Ausführung, solange ein Schlüssel existiert, damit eine laufende Integration nicht versehentlich unterbrochen wird. - Um stattdessen jeden Zugriff zu beenden, widerrufen Sie: Widerrufen im Dashboard oder
revoke_api_keymit confirm auf true. Anfragen schlagen danach fehl, bis ein neuer Schlüssel erstellt wird.
Was liefert ein fehlender oder falscher Schlüssel zurück?
Ein 401 mit dem Code unauthorized, bei einer Anfrage ohne Authorization-Header, bei einem Schlüssel, der nicht mit ec_live_ beginnt, oder bei einem Schlüssel, der rotiert oder widerrufen wurde. Die Meldung nennt den erwarteten Header. Kommen fehlgeschlagene Anfragen weiterhin von einer Adresse, antwortet die API stattdessen mit 429 rate_limited und den Sekunden, die vor dem nächsten Versuch zu warten sind.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Was kann ein gültiger Schlüssel sonst noch abweisen?
Ein gültiger Schlüssel authentifiziert das Konto, und der Status des Kontos gilt weiterhin. Diese Antworten kommen mit derselben Fehlerstruktur zurück:
- 402
billing_required: Auf dem Konto ist noch keine Karte hinterlegt, daher können keine Connect-Sitzungen gestartet werden. - 404
not_found: Die ID gehört zu keiner Verbindung, keinem Kanal und keiner Sitzung dieses Kontos, auch nicht zu solchen anderer Konten. - 409 removed: Die Verbindung wurde entfernt, daher kann ihr Webhook nicht mehr geändert werden.
- 402 suspended: Die Verbindung ist nach einem abgelaufenen Abonnement gesperrt; verbinden Sie sie zuerst erneut.
- 429
cap_reachedoderrate_limited: zu viele offene Connect-Sitzungen oder zu viele in dieser Stunde erstellt.
Häufige Fehler
- Den Schlüssel in den Frontend-Code legen. Jeder, der die Seite öffnet, kann ihn lesen, Verbindungen erstellen, die Ihnen berechnet werden, und mit ?credentials=1 die Tokens Ihrer Kunden abrufen.
- Rotieren, bevor Ihr Backend den neuen Schlüssel übernehmen kann. Der alte Schlüssel endet sofort, daher schlägt jede Anfrage mit 401 fehl, bis der neue bereitgestellt ist.
- Den Schlüssel in einer geteilten Unterhaltung erstellen. create_api_key gibt ihn im Chat zurück, wo er im Verlauf bleibt; rotieren Sie ihn, wenn diese Unterhaltung geteilt wurde.
- Den Schlüssel in Anführungszeichen speichern. Alles nach Bearer wird als Schlüssel gelesen, daher passt ein in Anführungszeichen gesetzter Wert nie, und jede Anfrage erhält 401.
easyCoexistence vergibt jedem Konto einen Partner-API-Schlüssel, sodass Ihr Backend die WhatsApp-Nummern Ihrer Kunden sowie deren Instagram-, Facebook-, TikTok-, YouTube- und LinkedIn-Konten verbinden kann, dazu weitere Kanäle, und anschließend die Zugangsdaten jeder Verbindung liest und deren Ereignisse weiterleitet. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit 3 Tagen kostenloser Testphase.
Häufig gestellte Fragen
Kann ein Konto mehr als einen API-Schlüssel haben?
Nein. Ein Konto hat jeweils einen Schlüssel, und ein neuer ersetzt den bisherigen. Getrennte Schlüssel bedeuten getrennte easyCoexistence-Konten, jeweils mit eigenen Verbindungen und eigener Abrechnung.
Laufen Partner-API-Schlüssel ab?
Nein. Ein Schlüssel funktioniert, bis er rotiert oder widerrufen wird, oder bis easyCoexistence ihn wegen Missbrauchs der Richtlinien von Meta beendet.
Brauchen meine Kunden meinen Schlüssel, um sich zu verbinden?
Nein. Sie öffnen nur den gehosteten Connect-Link, der seine eigene Sitzungs-ID enthält. Der Schlüssel bleibt auf Ihrem Server und wird ausschließlich von Ihrem Backend verwendet.
Ist der API-Schlüssel dasselbe wie das Signing-Secret für Ereignisse?
Nein. Der Schlüssel authentifiziert Ihre Anfragen an die API. Das Signing-Secret, das Sie einmal angezeigt bekommen, wenn Sie eine URL für Status-Ereignisse setzen, erlaubt Ihrem Endpoint, die von easyCoexistence gesendeten Ereignisse zu verifizieren.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am