Compréhensible par les machines. Sûr à appeler.
Une API Discovery en lecture seule et un serveur MCP pour les services Zephior et les connaissances publiées. Sans clé API, 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"}}}'Commencer par la plus petite surface utile
L'API Zephior Discovery publique aide les agents à identifier Zephior, distinguer Ziva, Zelius, Zeke et Zenith et rechercher notre bibliothèque multilingue. Elle n'est pas l'API produit authentifiée. Elle ne peut lire un compte, téléverser un fichier, créer un projet ni accéder aux connaissances client. Utilisez la présentation du site pour les questions d'entité et la recherche seulement pour un sujet publié précis.
Authentification et permissions
Les opérations Discovery publiques et le serveur MCP ne demandent aucun jeton. Ils sont en lecture seule et utilisent uniquement les données publiques du site. N'envoyez jamais identifiants, dossiers d'appel d'offres, noms de clients ou prompts privés. Le produit Zephior utilise séparément OAuth 2.0 et OpenID Connect. Les rôles d'organisation et permissions explicites limitent aussi chaque action produit.
Limites et cache
Les clients publics peuvent envoyer jusqu'à 120 requêtes par fenêtre de 60 secondes et par client. Les réponses exposent RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset et RateLimit-Policy. Une réponse 429 contient Retry-After. Attendez l'intervalle indiqué. Les réponses peuvent être brièvement mises en cache car leur source est publiée. Ces interfaces ne lancent aucun travail en arrière-plan.
Erreurs typées et récupération
Les erreurs API utilisent application/problem+json avec code stable, statut HTTP, détail lisible, URL d'instance, conseil de résolution et URL de documentation. Les paramètres invalides donnent 400, les routes versionnées inconnues 404 et la limite épuisée 429. MCP utilise les erreurs JSON-RPC 2.0 et des résultats avec isError pour les arguments invalides.
Versionnement et dépréciation
La surface REST utilise des versions majeures dans l'URL, en commençant par /api/v1. Les clients doivent ignorer les champs additifs inconnus. Une rupture reçoit un nouveau chemin majeur. 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.
MCP Streamable HTTP
Le point MCP expose get_zephior_overview et search_zephior_resources ainsi que des ressources de présentation, de sélection de service et de guide. Le transport sans état sous /mcp prend en charge initialize, tools/list, tools/call, resources/list et resources/read. Utilisez MCP pour les schémas déclarés, REST pour HTTP, llms.txt pour les consignes et llms-full.txt pour l'index complet.
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.