Zum Inhalt springen

Entwickler- und Agenten-Ressourcen

Jedes maschinenlesbare Dokument von Ivy an einem Ort. Kein Schlüssel, keine Registrierung, kein Aushandeln von Limits – jeder Endpunkt unten ist ein öffentliches GET.

Ivy ist so gebaut, dass Software es ebenso leicht nutzen kann wie Menschen. Die Website liefert eine OpenAPI-3.1-Beschreibung ihrer öffentlichen Oberfläche, llms.txt-Zusammenfassungen für Antwortmaschinen, Discovery-Dokumente unter /.well-known/ und über Accept-Header-Negotiation eine text/markdown-Fassung jeder Marketing-Seite. Alles auf dieser Seite ist stabil, versioniert und für Automatisierung geeignet.

Markdown-Content-Negotiation

Senden Sie Accept: text/markdown an eine beliebige Marketing-Seite und Sie erhalten sauberes Markdown statt HTML – kein Scraping, kein DOM-Parsing. Das folgt der Konvention von acceptmarkdown.com.

curl -H 'Accept: text/markdown' https://ivy.app/product

Rate Limits

Öffentliche Endpunkte weisen ihr Anfragebudget über die RateLimit-Header des IETF-Entwurfs aus, sodass ein Client die Obergrenze erkennen kann, statt sie durch eine Sperre zu entdecken. Dokumente werden aus dem Cache ausgeliefert und stündlich revalidiert; ein Client, der Cache-Control beachtet, kann das Budget also nicht ausschöpfen. Wird ein Budget doch überschritten, antwortet der Endpunkt mit 429, einem Retry-After-Header und einem Problem-Dokument nach RFC 9457.

RateLimit-Limit – im aktuellen Zeitfenster erlaubte AnfragenRateLimit-Remaining – noch verfügbare AnfragenRateLimit-Reset – Sekunden bis zum Zurücksetzen des ZeitfenstersRateLimit-Policy – die Richtlinie als Kontingent und Zeitfenster

Versionierung und Abkündigung

Agenten-Endpunkte sind über den Pfad versioniert (/api/v1/). Breaking Changes erscheinen unter einer neuen Version, statt eine bestehende zu verändern. Wird eine Operation eingestellt, wird sie zunächst im OpenAPI-Dokument als deprecated markiert und liefert vor der Entfernung mindestens 180 Tage lang Deprecation- und Sunset-Header, gemäß RFC 9745 und RFC 8594.

Mit Ivy entwickeln

Tendril ist source-available, und die Orchestrierungsschicht läuft auf Ihrem eigenen Rechner.