API-Referenz

Webhook-Requests empfangen

ANY https://provider.tools/webhooks/{token}

Authentifizierung: Nicht erforderlich (öffentlicher Endpunkt)

Methoden: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS

Response: Gibt die konfigurierte benutzerdefinierte Response zurück (Standard: 200 OK)

Nebeneffekt: Der Request wird gespeichert und ist in der Webhook Tester-Oberfläche sichtbar

Beispiel

curl -X POST https://provider.tools/webhooks/a3f8b2c1d9 \
  -H "Content-Type: application/json" \
  -d '{"event": "order.completed", "order_id": 42}'

# Response: 200 OK (oder Ihre benutzerdefinierte Response)

Alle Verwaltungs-Endpunkte erfordern Authentifizierung via Session-Cookie.

Endpunkte auflisten

GET /api/webhook/endpoints

Response:
{
  "success": true,
  "endpoints": [
    {
      "id": "uuid",
      "token": "a3f8b2c1d9",
      "label": "Mein Test-Webhook",
      "responseStatus": 200,
      "requestCount": 42,
      "createdAt": "2025-01-01T00:00:00Z"
    }
  ]
}

Endpunkt erstellen

POST /api/webhook/endpoints
Body: { "label": "Mein Webhook" }  // optional

Response:
{
  "success": true,
  "endpoint": { "id": "uuid", "token": "a3f8b2c1d9", ... }
}

Endpunkt-Einstellungen aktualisieren

PUT /api/webhook/endpoints/{id}
Body: {
  "label": "Neuer Name",
  "responseStatus": 201,
  "responseBody": "{\"ok\": true}",
  "responseType": "application/json",
  "cors": true,
  "timeout": 500
}

Endpunkt löschen

DELETE /api/webhook/endpoints/{id}

Aufgezeichnete Requests auflisten

GET /api/webhook/endpoints/{id}/requests?limit=100&since=2025-01-01T00:00:00Z

Alle Requests löschen

DELETE /api/webhook/endpoints/{id}/requests