API-Übersicht

Die Conare API ist JSON über HTTPS. Jeder Endpunkt hat in diesem Tab eine Seite mit einem Playground.


Basis-URL	`https://api.conare.ai`
Auth	`Authorization: Bearer $CONARE_API_KEY`
Schlüssel	Werden in der Konsole erstellt; bewahren Sie sie auf Ihrem Server auf
Bodys	JSON, snake_case; unbekannte Felder ergeben `400`
Spezifikation	api.conare.ai/openapi.yaml

curl https://api.conare.ai/namespaces \
  -H "Authorization: Bearer $CONARE_API_KEY"

Die OpenAI- und Cohere-kompatiblen Routen (/v1, /v2) ignorieren unbekannte Felder.

Fehler

{
  "error": {
    "code": "invalid_request",
    "message": "documents[0].text is required",
    "request_id": "45ea7c7353368cb646e5cc2303008072"
  }
}

Status	Bedeutung
400	Die Anfrage ist ungültig; `message` nennt den Grund
401	Der Schlüssel fehlt, ist falsch oder widerrufen
403	Der Schlüssel hat keinen Zugriff auf diesen Namespace oder diese Route
404	Nicht gefunden
409	Ein Versionskonflikt, oder ein gleichzeitiger Schreibvorgang hat gewonnen
413	Der Body, ein Dokument oder eine Datei ist zu groß
415	Der Dateityp wird nicht unterstützt
422	Die Datei kann nicht gelesen werden, oder ein `Idempotency-Key` wurde für eine andere Anfrage wiederverwendet
429	Über einem Rate-Limit
5xx	Ein Problem auf unserer Seite

Wiederholungen

Fall	Vorgehen
`429`, `503`	Nach den Sekunden im Header `Retry-After` wiederholen
Andere 5xx	Mit Backoff wiederholen
Schreib- und Löschvorgänge	Senden Sie einen `Idempotency-Key` (eine UUID); eine Wiederholung innerhalb von 24 Stunden liefert die erste Antwort mit `Idempotent-Replayed: true` und ändert nichts

Das SDK wiederholt Anfragen und sendet Idempotency-Key für Sie.

Rate-Limits

Pro Organisation. Lastspitzen im Umfang von bis zu 10 Sekunden sind in Ordnung; über einem Limit gibt die API 429 mit Retry-After zurück.

Aufrufe	Pro Sekunde	Gleichzeitig in Bearbeitung
Suche	100	128
Schreiben	100 Dokumente	64
Embed	100 Texte	16
Rerank	20	16
turbopuffer API-Abfragen	1.000
Alles andere	100

Header	Richtung	Bedeutung
`Authorization`	Anfrage	`Bearer` und Ihr Schlüssel
`Idempotency-Key`	Anfrage	Macht einen Schreibvorgang sicher wiederholbar
`X-Conare-Org`	Anfrage	Die Organisation, für die gehandelt wird, bei einem Schlüssel für mehrere Organisationen (auflisten)
`Content-Encoding: gzip`	Anfrage	Ein komprimierter Body; Limits zählen ihn dekomprimiert
`X-Request-Id`	Antwort	In jeder Antwort; geben Sie sie an, wenn Sie den Support kontaktieren
`Retry-After`	Antwort	Wartezeit in Sekunden, bei `429` und `503`
`Conare-Degraded`	Antwort	Die Anfrage war erfolgreich, aber ohne einen Teil ihrer Arbeit, etwa das Reranking (Werte)
`Idempotent-Replayed`	Antwort	`true`, wenn eine Wiederholung die erste Antwort erhalten hat

Status

GET /health/deep benötigt keinen Schlüssel: status ist ok, degraded (beide HTTP 200) oder down (HTTP 503).

Response

{ "status": "ok", "checkedAt": "2026-10-21T21:39:16.729996745Z" }

Überblick

Namespaces

Dokumente

Suche

Dateien

Parsen

Quellen

Eigene Quellen

Modelle

Benutzer

Ereignisse

Organisationen

Status

API-Übersicht

Fehler

Wiederholungen

Rate-Limits

Header

Status

​Fehler

​Wiederholungen

​Rate-Limits

​Header

​Status

Fehler

Wiederholungen

Rate-Limits

Header

Status