Änderungsprotokoll

So lesen Sie die Versionen

Der Pfad trägt die Hauptversion (/v1); info.version im OpenAPI-Dokument trägt die hier aufgeführten kompatiblen Änderungen. Alle sind additiv: kein Feld entfernt, kein Pflichtfeld hinzugefügt. Ein Bruch würde /v2 ergeben, parallel ausgeliefert. Jeder Eintrag trägt das Datum der Änderung.

1.2.0 — Signierte Webhooks.

Veröffentlicht am 5. November 2026

• Endpunkte für Webhooks: GET und POST /v1/webhooks, GET, PATCH und DELETE /v1/webhooks/{id}, POST /v1/webhooks/{id}/rotate und POST /v1/webhooks/{id}/test. Lesen erfordert read, jede Änderung write; höchstens zehn Endpunkte je Konto.
• Vier Ereignisse — search.finished, prospect.replied, application.received, partner.approved — signiert nach der Spezifikation Standard Webhooks (webhook-id, webhook-timestamp, webhook-signature). Das Geheimnis whsec_ wird einmal angezeigt; nach einer Rotation signiert das alte 24 Stunden lang mit.
• Eine fehlgeschlagene Zustellung wird nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 12 Stunden wiederholt. Die Nutzdaten enthalten Kennungen und Zählwerte, nie eine E-Mail-Adresse oder eine Nachricht.
• Webhooks sind nicht als MCP-Werkzeuge verfügbar: Ihre Geheimnisse landeten sonst in den Verläufen der Assistenten.
• Ein unbekannter Pfad unter /api/v1 antwortet jetzt nach der Authentifizierung mit 404 not_found als application/problem+json statt mit einer HTML-Seite.

1.1.0 — Partnergewinnung über die API und der MCP-Server.

Veröffentlicht am 26. Oktober 2026

• 29 neue Operationen für alles, was die Bildschirme zur Partnergewinnung können: Websites, Kriterien und ihre generierten Themenbegriffe, die Partnersuche und ihre letzten Ergebnisse, die Auswahl und ihre Übernahme als Interessenten, Interessenten und die kostenpflichtige E-Mail-Suche, die dialogbasierte Suche, der Creator-Index (Suche, Profil, ähnliche Profile, Bibliothek gefundener Creator), Wettbewerber und Outreach — Postfächer, Sequenzen, Aufnahme. Kein Endpunkt sendet direkt eine E-Mail.
• Die Geltungsbereiche read, search, write und spend; vor 1.1 erstellte Schlüssel behalten genau read.
• Die Kostenbestätigung: Eine Operation, die Anbieter-Credits verbraucht, erfordert spend und ein confirmCost, das mindestens der Schätzung entspricht; andernfalls antwortet sie mit 402 cost_confirmation_required, der Schätzung in error.details, und gibt nichts aus. Bestätigte Ausgaben werden protokolliert.
• Idempotency-Key bei Schreibzugriffen (24 Stunden, nur Erfolge), Request-Bodys auf 32 KiB begrenzt (413 payload_too_large), eine Ratenbegrenzung je Konto zusätzlich zu der je Schlüssel und 20 neue Fehlercodes.
• Der MCP-Server unter /api/mcp (Streamable HTTP, Protokollversionen 2025-11-25 bis zurück zu 2024-11-05): 29 Werkzeuge nach dem Vorbild der API, mit denselben Schlüsseln und Geltungsbereichen; kostenpflichtige Werkzeuge werden zweistufig mit einem confirmToken bestätigt.

1.0.0 — Der erste Vertrag, nur lesend.

Veröffentlicht am 25. Juli 2026

• Vier Operationen: das öffentliche Programmverzeichnis (GET /v1/programs, GET /v1/programs/{slug}), das aufrufende Konto (GET /v1/me) und seine Provisionen (GET /v1/commissions).
• Bearer-Schlüssel gaff_live_…, als Hash gespeichert und einmal angezeigt; eine Ratenbegrenzung je Schlüssel nach Tarif, mit X-RateLimit-Limit, X-RateLimit-Remaining und Retry-After.
• Cursor-Paginierung, Browser-Ursprünge abgewiesen (CORS) und ein OpenAPI-3.1-Dokument, abgeleitet aus den Schemata, die die Routen erzwingen.