Für Maschinen verständlich. Sicher aufrufbar.
Read-only APIs und Agent Tools für publiziertes Zephior-Wissen. Keine Kundendaten und keine Mutation.
Öffentliche REST API
curl "https://zephior.com/api/v1/site?locale=de"curl "https://zephior.com/api/v1/search?q=RFP%20automation&locale=de"MCP
curl -X POST "https://zephior.com/mcp" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"example","version":"1.0.0"}}}'Go SDK and CLI
go get github.com/Zephior/zephior-agent-toolkit@latest
go install github.com/Zephior/zephior-agent-toolkit/cmd/zephior@latestAgent Skills
npx skills add Zephior/zephior-agent-toolkitMit der kleinsten sinnvollen Schnittstelle beginnen
Die öffentliche Zephior Discovery API identifiziert Zephior, unterscheidet Ziva von Zelius und durchsucht unsere mehrsprachige Publikationsbibliothek. Sie ist nicht die authentifizierte Ziva Produkt-API. Sie kann weder Accounts lesen noch Dateien hochladen, Projekte erstellen, auf Kundenwissen zugreifen, den Tender-Universe-Datensatz durchsuchen oder Produktzustände verändern.
Grenze der Ausschreibungssuche
Die Marketing-Website zeigt eine begrenzte Live-Vorschau mit offenen oder geplanten Datensätzen, reinen Datumsfeldern und opaken Vorschau-Referenzen. Ausschreibungssuche, Ergebnisdetails, Historie und Produkt-Workflows erfordern ein authentifiziertes Ziva-Konto. Der Website-Vorschau-Transport wird nicht als API, MCP Tool, WebMCP Tool oder wiederverwendbarer Integrationsvertrag publiziert.
Authentifizierung und Berechtigungen
Die öffentlichen Discovery- und Dokumentations-MCP-Operationen benötigen kein Client-Token. Sie sind absichtlich read-only und arbeiten nur mit publizierten Zephior-Inhalten. Senden Sie niemals Credentials, Ausschreibungsdateien, Kundennamen oder private Prompts an diese Schnittstellen. Ziva nutzt OAuth 2.0 und OpenID Connect über auth.zephior.com sowie Organisationsrollen, explizite Berechtigungen und Subscription-Prüfungen.
Rate Limits und Caching
Die öffentliche Discovery API erlaubt 120 Anfragen je 60 Sekunden und Client. Beachten Sie RateLimit- und Retry-After-Header. Publizierte Discovery-Antworten verwenden explizite Cache-Regeln. Limits und Cache-Verhalten des Ziva-Produkts gehören zum authentifizierten Produktvertrag, nicht zu dieser öffentlichen API.
Typisierte Fehler und Recovery
Versionierte Discovery-API-Fehler verwenden application/problem+json mit stabilem Code, Status, Detail, Instance-URL, Lösungshinweis und Dokumentations-URL. MCP nutzt JSON-RPC-2.0-Fehler und Tool-Ergebnisse mit isError.
Versionierung und Deprecation
Die Discovery REST-Schnittstelle verwendet Major-Versionen im URL-Pfad, beginnend mit /api/v1. Clients sollen unbekannte additive Felder ignorieren. Breaking Changes erhalten einen neuen versionierten Pfad. Bei einer Stilllegung publiziert Zephior Deprecation- und Sunset-Header sowie einen dokumentierten Migrationspfad mit mindestens 180 Tagen Vorlauf.
Ausschreibungszugang, Agents und MCP
Die Ausschreibungssuche authentifiziert sich über Ziva und dessen Access-Policy-Ebene. Öffentliche Agents verbinden sich nie direkt mit Tender Universe PostgreSQL, Qdrant, NATS oder der privaten Delivery API. Öffentliche Discovery- und MCP-Schnittstellen liefern nur publizierte Zephior-Inhalte, niemals Tender-Universe-, Subscription- oder Kundendaten.
MCP Streamable HTTP
Der öffentliche Dokumentations-MCP-Endpunkt bietet Tools für das Unternehmen und publizierte Ressourcen. Eine separate Product-Decision-MCP-Schnittstelle vergleicht publizierte Ziva-Kapazitäts-Checkpoints und Zephior-Servicegrenzen. Keine Schnittstelle bietet Ausschreibungssuche oder Tender-Universe-Datensätze. Beide zustandslosen Transports unterstützen initialize, tools/list, tools/call, resources/list und resources/read.
Produktintegration geplant?
Nennen Sie Workflow, Datengrenze und benötigte Aktionen. Wir identifizieren den passenden Weg.