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"}}}'JavaScript SDK
npm install github:Zephior/zephior-agent-toolkit#v0.4.0Go 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 publizierte Website-Inhalte. Sie bietet keinen Zugriff auf Kunden- oder private Servicedaten.
Grenze der Ausschreibungssuche
Publizierte Bekanntmachungen sind über /api/v1/tenders, Dokumentations-MCP und WebMCP verfügbar. Länder, Kategorien, Status und Textsuche lassen sich kombinieren. Innerhalb eines Filters gilt ODER, zwischen Filtern UND. Fehlende Angaben werden als nicht verfügbar ausgewiesen. Private Zugangsdaten bleiben privat.
Öffentlicher Zugriff
Die öffentliche Discovery API und das Dokumentations-MCP benötigen kein Client-Token. Sie sind read-only und arbeiten nur mit publizierten Zephior-Inhalten. Senden Sie niemals Credentials, Ausschreibungsdateien, Kundennamen oder private Prompts an diese Schnittstellen.
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.
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.
Nur publizierte Inhalte
Öffentliche Discovery- und MCP-Schnittstellen liefern nur publizierte Zephior-Seiten und Ressourcen. Sie legen keine privaten Datensätze, Subscriptions, Kundendaten oder interne Service-Infrastruktur offen.
MCP Streamable HTTP
Die öffentlichen MCP-Endpunkte stellen Informationen zum Unternehmen, zu Services, Preisen und publizierten Ressourcen für die Discovery bereit. Sie legen keine privaten Datensätze oder Kundendaten offen und können keine Anwendungszustände verändern. 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.