Für Maschinen verständlich. Sicher aufrufbar.

Read-only APIs und Agent Tools für publiziertes Zephior-Wissen. Keine Kundendaten und keine Mutation.

Quickstart

Ö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@latest

Agent Skills

npx skills add Zephior/zephior-agent-toolkit

Mit 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

Die Marketing-Website zeigt eine begrenzte Live-Vorschau mit offenen oder geplanten Datensätzen, reinen Datumsfeldern und opaken Vorschau-Referenzen. Der Website-Vorschau-Transport wird nicht als API, MCP Tool, WebMCP Tool oder wiederverwendbarer Integrationsvertrag publiziert.

Ö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.