Compréhensible par les machines. Sûr à appeler.
Des API et outils agent en lecture seule pour les connaissances Zephior publiées. Sans données client ni mutation.
API REST publique
curl "https://zephior.com/api/v1/site?locale=fr"curl "https://zephior.com/api/v1/search?q=RFP%20automation&locale=fr"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-toolkitCommencer par la plus petite surface utile
L'API Zephior Discovery publique identifie Zephior, distingue Ziva de Zelius et recherche notre bibliothèque multilingue. Elle n'est pas l'API produit Ziva authentifiée. Elle ne peut lire un compte, téléverser un fichier, créer un projet, accéder aux connaissances client, rechercher les données Tender Universe ou modifier l'état du produit.
Frontière de la recherche tender
Le site marketing affiche un aperçu en direct limité aux enregistrements ouverts ou planifiés, aux dates métier sans heure et aux références d'aperçu opaques. La recherche, le détail des résultats, l'historique et les processus produit exigent un compte Ziva authentifié. Le transport de cet aperçu n'est pas publié comme API, outil MCP, outil WebMCP ou contrat d'intégration réutilisable.
Authentification et permissions
Les opérations publiques Discovery et MCP de documentation ne demandent aucun jeton client. Elles sont en lecture seule et utilisent uniquement les contenus Zephior publiés. N'envoyez jamais identifiants, dossiers d'appel d'offres, noms de clients ou prompts privés. Ziva utilise OAuth 2.0 et OpenID Connect via auth.zephior.com, ainsi que des rôles, permissions explicites et contrôles d'abonnement.
Limites et cache
L'API Discovery publique accepte 120 requêtes par période de 60 secondes et par client. Respectez RateLimit et Retry-After. Les réponses Discovery publiées utilisent des règles de cache explicites. Les limites et le cache du produit Ziva relèvent du contrat produit authentifié, pas de cette API publique.
Erreurs typées et récupération
Les erreurs de l'API Discovery versionnée utilisent application/problem+json avec code stable, statut, détail, URL d'instance, conseil et URL de documentation. MCP utilise les erreurs JSON-RPC 2.0 et les résultats isError.
Versionnement et dépréciation
La surface REST Discovery utilise des versions majeures dans l'URL, à partir de /api/v1. Les clients doivent ignorer les champs additifs inconnus. Une rupture reçoit un nouveau chemin versionné. Si une version publique est retirée, Zephior publie les en-têtes Deprecation et Sunset et un chemin de migration avec au moins 180 jours de préavis.
Accès tender, agents et MCP
La recherche tender s'authentifie via Ziva et sa couche de politique d'accès. Les agents publics ne se connectent jamais directement à PostgreSQL, Qdrant, NATS ou à l'API privée de Tender Universe. Les interfaces publiques Discovery et MCP renvoient uniquement les contenus Zephior publiés, jamais les données Tender Universe, d'abonnement ou client.
MCP Streamable HTTP
Le point MCP public expose des outils sur la société et les ressources publiées. Une surface séparée compare les paliers de capacité Ziva publiés et les frontières de service Zephior. Aucune n'expose la recherche tender ou les données Tender Universe. Les deux transports sans état prennent en charge initialize, tools/list, tools/call, resources/list et resources/read.
Besoin d’une intégration produit ?
Décrivez le processus, la frontière des données et les actions requises. Nous identifierons la voie adaptée.