Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Uwierzytelnianie Partner API: klucze Bearer ec_live_, rotacja i błędy 401

Każde żądanie Partner API przenosi sekretny klucz konta w nagłówku Authorization: Bearer ec_live_…, wysyłany z Twojego serwera. Każde konto easyCoexistence ma jeden klucz, utworzony w panelu w sekcji Profile, Developers albo przez poproszenie asystenta AI o uruchomienie create_api_key, i pokazywany tylko raz. Rotacja wystawia nowy klucz i natychmiast kończy stary; brakujący lub błędny klucz zwraca 401 unauthorized.

ec_live_

Prefiks, od którego zaczyna się każdy klucz Partner API, wysyłany przy każdym żądaniu jako Authorization: Bearer.

1 key

Ile kluczy konto posiada naraz; każde połączenie utworzone z ich użyciem należy do tego konta.

401

Status dla brakującego lub nieprawidłowego klucza, z kodem błędu unauthorized i komunikatem wskazującym oczekiwany nagłówek.

Once

Moment, w którym pełny klucz jest pokazywany: przy utworzeniu lub rotacji; potem widoczne są tylko jego pierwsze znaki.

Jak żądanie się uwierzytelnia?

Klucz przesyłany jest jako token Bearer w nagłówku Authorization każdego żądania do https://easycoexistence.com/api/v1. Nic innego nie jest podpisywane ani ograniczane zakresem: klucz identyfikuje konto, a wszystko, co żądanie tworzy lub odczytuje, należy do tego konta. Treści są w formacie JSON, a każdy błąd wraca jako obiekt z kodem i komunikatem.

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

Gdzie tworzy się klucz?

W panelu albo z asystenta AI, z tym samym wynikiem. W panelu otwórz Profile, następnie Developers, i naciśnij Create API key. W Claude, ChatGPT lub innym asystencie połączonym z serwerem MCP easyCoexistence poproś o skonfigurowanie Partner API: get_partner_setup pokazuje, czego brakuje, a create_api_key zwraca klucz. Tak czy inaczej pełny klucz pojawia się raz, więc od razu zapisz go w sekretach swojego backendu.

Dlaczego klucz jest pokazywany tylko raz?

Bo przechowywany jest tylko jego hash. easyCoexistence trzyma hash do sprawdzania każdego żądania oraz pierwsze znaki klucza, ec_live_ i sześć kolejnych, aby panel mógł pokazać, który klucz jest aktywny i kiedy został utworzony. Zgubionego klucza nie da się pokazać ponownie; rotacja go zastępuje.

Jak rotować lub unieważnić klucz?

Jednym krokiem, a stary klucz przestaje działać w tej chwili, bez okresu łaski, ponieważ wyciek to zwykle powód rotacji. Nowy klucz pokazywany jest raz, tak jak pierwszy:

  • Panel: Profile, Developers, Rotate key.
  • MCP: create_api_key z replace_existing ustawionym na true. Bez tego narzędzie odmawia, gdy klucz istnieje, dzięki czemu działająca integracja nie zepsuje się przypadkiem.
  • Aby zamiast tego zablokować cały dostęp, unieważnij: przycisk Revoke w panelu albo revoke_api_key z confirm ustawionym na true. Żądania wtedy kończą się błędem, dopóki nie zostanie utworzony nowy klucz.

Co zwraca brakujący lub błędny klucz?

401 z kodem unauthorized, dla żądania bez nagłówka Authorization, klucza, który nie zaczyna się od ec_live_, albo klucza, który został zrotowany lub unieważniony. Komunikat wskazuje oczekiwany nagłówek. Gdy nieudane żądania nadal napływają z jednego adresu, API odpowiada zamiast tego 429 rate_limited, z liczbą sekund do odczekania przed ponowną próbą.

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

Co jeszcze może odrzucić ważny klucz?

Ważny klucz uwierzytelnia konto, ale stan konta nadal obowiązuje. Te odpowiedzi mają ten sam kształt błędu:

  • 402 billing_required: na koncie nie ma jeszcze karty, więc nie można rozpocząć sesji połączenia.
  • 404 not_found: identyfikator nie należy do żadnego połączenia, kanału ani sesji tego konta, także tych na innych kontach.
  • 409 removed: połączenie zostało usunięte, więc jego webhook nie może się zmienić.
  • 402 suspended: połączenie zostało zawieszone po wygaśnięciu subskrypcji; najpierw połącz je ponownie.
  • 429 cap_reached lub rate_limited: zbyt wiele otwartych sesji połączenia albo zbyt wiele utworzonych w ciągu godziny.

Typowe błędy

  • Umieszczenie klucza w kodzie front-endu. Każdy, kto otworzy stronę, może go odczytać, utworzyć połączenia obciążające Twoje konto i pobrać tokeny klientów przez ?credentials=1.
  • Rotacja przed tym, jak backend przyjmie nowy klucz. Stary klucz przestaje działać od razu, więc każde żądanie kończy się błędem 401, aż nowy zostanie wdrożony.
  • Utworzenie klucza w udostępnionej rozmowie. create_api_key zwraca go na czacie, gdzie zostaje w historii, więc jeśli rozmowa jest udostępniona, zrotuj klucz.
  • Zapisanie klucza w cudzysłowach. Wszystko po Bearer jest odczytywane jako klucz, więc wartość ujęta w cudzysłów nigdy nie pasuje i każde żądanie dostaje 401.
Z EasyCoexistence zrobisz to

easyCoexistence daje każdemu kontu jeden klucz Partner API, dzięki czemu Twój backend może łączyć numery WhatsApp Twoich klientów oraz ich konta Instagram, Facebook, TikTok, YouTube i LinkedIn, a także kolejne kanały, a następnie odczytywać dane logowania każdego połączenia i kierować jego zdarzenia. US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym na pierwsze 3 dni.

Najczęściej zadawane pytania

Czy konto może mieć więcej niż jeden klucz API?

Nie. Konto ma jeden klucz naraz, a utworzenie nowego zastępuje poprzedni. Osobne klucze oznaczają osobne konta easyCoexistence, każde z własnymi połączeniami i własnym rachunkiem.

Czy klucze Partner API wygasają?

Nie. Klucz działa do momentu rotacji lub unieważnienia albo do chwili, gdy easyCoexistence go zakończy z powodu nadużycia zasad Meta.

Czy moi klienci potrzebują mojego klucza, żeby się połączyć?

Nie. Otwierają tylko hostowany link do połączenia, który ma własny identyfikator sesji. Klucz pozostaje na Twoim serwerze i używa go wyłącznie Twój backend.

Czy klucz API to to samo co sekret podpisywania zdarzeń?

Nie. Klucz uwierzytelnia Twoje żądania do API. Sekret podpisywania, pokazywany raz po ustawieniu adresu URL zdarzeń statusu, pozwala Twojemu endpointowi zweryfikować zdarzenia wysyłane przez easyCoexistence.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w