Testowanie
Zdarzenie testowe, podgląd dostarczeń, ponowna wysyłka i dostęp do zapisanych payloadów.
Wyślij zdarzenie testowe
W aplikacji: przy webhooku kliknij „Wyślij testowy ping" albo wybierz konkretny typ zdarzenia. Przez API — klucz z zakresem webhooks.write:
curl -X POST https://app.mediflo.ai/api/external/v1/webhook-endpoints/{endpointId}/test \
-H "Authorization: Bearer mflo_live_…" \
-H "Content-Type: application/json" \
-d '{ "eventType": "bot_call.completed" }'Bez eventType wysyłamy ping. Testowe zdarzenie ma prawdziwy podpis, przykładową kopertę z katalogu i nagłówek Mediflo-Event-Test: true. Szczegóły: POST /webhook-endpoints/{endpointId}/test.
Sprawdź, co się stało
Lista dostarczeń pokazuje każdą próbę ze statusem, kodem odpowiedzi i czasem:
curl "https://app.mediflo.ai/api/external/v1/webhook-deliveries?endpointId={endpointId}&limit=20" \
-H "Authorization: Bearer mflo_live_…"Wymaga zakresu webhooks.read. Referencja: GET /webhook-deliveries.
Wyślij ponownie po naprawie
Dostarczenie w stanie EXHAUSTED (albo dowolne inne) odtworzysz jednym żądaniem:
curl -X POST https://app.mediflo.ai/api/external/v1/webhook-deliveries/{deliveryId}/redeliver \
-H "Authorization: Bearer mflo_live_…"Ponowna wysyłka niesie tę samą kopertę i ten sam id, więc idempotentny odbiornik po prostu ją zdeduplikuje. Referencja: POST /webhook-deliveries/{deliveryId}/redeliver.
Podgląd zapisanego payloadu
Treść dostarczenia możesz odczytać przez GET /webhook-deliveries/{deliveryId}/payload. Ten endpoint wymaga zakresu webhook-payloads.read, którego nie obejmuje żaden wildcard (webhooks.* ani *) — trzeba go nadać kluczowi jawnie, bo payload może zawierać dane osobowe, w tym dane wrażliwe.
Odbiornik do testów
Nie masz jeszcze własnego serwera? Na czas testów wystarczy publiczny adres https:// z dowolnego narzędzia do podglądu żądań. Pamiętaj tylko, że wysłane tam zdarzenia testowe nie zawierają prawdziwych danych — ale prawdziwe już tak, więc przed włączeniem bloków z danymi osobowymi przełącz się na własny odbiornik.