Listar webhooks
Devuelve los endpoints activos de tu empresa. El secret nunca vuelve a mostrarse: si lo perdiste, elimina el endpoint y regístralo de nuevo.
curl https://faktura-test.cgallardo.me/v1/webhooks -H "Authorization: Bearer sk_test_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/webhooks');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/webhooks', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Método: GET
Endpoint
Sección titulada «Endpoint»GET https://faktura-test.cgallardo.me/v1/webhooksGET https://faktura.cgallardo.me/v1/webhooksRespuesta 200 OK
Sección titulada «Respuesta 200 OK»{ "items": [ { "id": "01a1d6b2-4c1e-7f30-9a2b-5d8e7c6b1a00", "url": "https://erp.miempresa.pe/faktura/webhook", "events": ["document.accepted", "document.rejected"], "is_active": true, "created_at": "2026-11-13T22:00:00+00:00" } ]}| Campo | Descripción |
|---|---|
id |
Identificador del endpoint, para eliminarlo. |
url |
URL que recibe los avisos. |
events |
Eventos suscritos (lista de eventos). |
is_active |
true mientras recibe avisos. |
created_at |
Fecha de registro (UTC, ISO 8601). |
Respuestas y errores
Sección titulada «Respuestas y errores»| Estado | reason |
Significado |
|---|---|---|
200 |
— | Devuelve la lista de webhooks activos de tu empresa. |
401 |
Unauthenticated |
Falta la API key, es inválida o venció. |
403 |
ApiKeyScopeInsufficient |
La clave es de alcance lookup. |
429 |
TooManyRequests |
Superaste las 120 peticiones por minuto. |