Token API pozwala Twojemu własnemu kodowi komunikować się z Ocoya. Znajdziesz je w Settings → API. Settings jest w menu konta, czyli pod awatarem u góry paska bocznego.
Ta strona opisuje zarządzanie tokenami. Jak faktycznie wywoływać API — adres bazowy, nagłówek, endpointy — znajdziesz w dokumentacji REST API.
Zacznij tutaj. Menu konta to awatar u góry paska bocznego — wybierz Settings, a potem API na pasku bocznym ustawień.
Settings → API, z wykresem żądań u góry i Twoimi tokenami poniżej.
Utwórz token
Wybierz Create token i nadaj mu nazwę. Nazwa jest tylko dla Ciebie — pozwala później odróżnić tokeny i unieważnić właściwy.
Nazywaj tokeny według miejsca użycia, a nie tego, co robią. Zapier, staging server, reporting script mówi Ci, co przestanie działać po unieważnieniu. API key 2 tego nie mówi.
Skopiuj token od razu po utworzeniu i zapisz go w bezpiecznym miejscu. Potem Ocoya pokazuje tylko kilka pierwszych i ostatnich znaków.
Do czego token daje dostęp
Każdy token ma dostęp do wszystkich marek należących do tego konta. Nie można ograniczyć tokenu do jednej marki — lista tokenów przy każdym z nich pokazuje All brands.
Ma to znaczenie, jeśli planowałeś dać deweloperowi klienta token tylko do jego marki. Nie da się. Miałby dostęp do wszystkich Twoich marek.
Unieważnij token
Menu ⋯ przy każdym tokenie zawiera Delete token. Usunięcie jest natychmiastowe i nieodwracalne — wszystko, co używa tego tokenu, od razu przestaje działać, więc najpierw upewnij się, co go używa. Do tego służą nazwy.
Nie można zrotować tokenu w miejscu. Aby go wymienić: utwórz nowy token, przenieś integrację, a potem usuń stary.
Śledzenie użycia
Wykres API usage pokazuje uwierzytelnione żądania dla bieżącej marki z ostatniej godziny, doby lub 30 dni. To najszybszy sposób, żeby potwierdzić, że integracja faktycznie wywołuje Ocoya, albo zauważyć taką, która wywołuje je znacznie częściej, niż się spodziewasz.
Ocoya dopuszcza 60 żądań na minutę na klucz, a powyżej tego limitu zwraca 429 Too Many Requests. Pełne szczegóły, w tym nagłówki limitów, znajdziesz w Rate limits.