Wysłanie podpisanego zdarzenia testowego na adres URL webhooka
- W sandboxie
Prostymi słowami
Treść zawiera event_id, type (zawsze test), occurred_at i message, podpisane jak zdarzenie statusu. Nie dotyczy żadnej faktury. Od 0.16.0 każdy parametr zapytania daje odpowiedź 400.
apiKeyAuthorizationBearer <token>Klucz należy wysyłać jako token typu bearer: Authorization: Bearer <your-api-key>. Wywołanie stanu usługi jest jedynym, które nie wymaga klucza.
Co odpowiedział punkt końcowy partnera.
application/json- response
delivered*booleanhttp_status*integer|nullduration_ms*integercurl -X POST "https://example.com/webhook/test" \ -H "Authorization: Bearer <your-api-key>"{ "delivered": true, "http_status": 0, "duration_ms": 0}Ustawienie adresu URL webhooka albo rotacja jego sekretu PUT
Klucz operatora ustawia webhook operatora, który dostaje zdarzenia wszystkich klientów; klucz administratora klienta ustawia webhook tego klienta, który dostaje tylko jego zdarzenia. Pierwsze wywołanie wymaga url i tworzy sekret, który jest zwracany raz. Rotacja zwraca nowy sekret raz. Przez 24 godziny usługa podpisuje każde dostarczenie zarówno nowym, jak i starym sekretem, aby partner mógł przełączyć się bez utraty zdarzeń. Dostarczane są tylko zdarzenia zapisane po pierwszym wywołaniu. Adres URL musi być https, a każdy adres, na który rozwiązuje się jego host, musi być publiczny: adresy pętli zwrotnej, prywatne, link-local, carrier-grade NAT, multicast, zarezerwowane i metadanych chmury są odrzucane, tu i ponownie przed każdym dostarczeniem. Przekierowania nie są wykonywane. Od 0.16.0 każdy parametr zapytania daje odpowiedź 400, więc błędnie napisane client nigdy nie zmieni własnego webhooka operatora.
Hostowany sandbox i jak poprosić o klucz.