Weftd back to homepage

API et serveur MCP Weftd

La Présence IA de Weftd est accessible aux programmes autant qu'aux personnes : une API HTTP qui répond aux questions sur Weftd, et un serveur MCP pour les assistants IA. Les deux sont publics et ne demandent aucune clé.

En bref

SurfaceURLDescription
API HTTPhttps://weftd.weftd.space/api/v1Posez une question en langage naturel, recevez du JSON ou du texte brut. weftd.com/api/v1 redirige ici ; /api est un alias de la version courante.
OpenAPIhttps://www.weftd.com/openapi.jsonDescription OpenAPI 3.1 de l'API HTTP.
Serveur MCPhttps://weftd.weftd.space/mcpEndpoint Streamable HTTP pour les assistants IA (Claude, ChatGPT, Cursor…).

Authentification

Aucune pour le space public de Weftd : appelez l'API et connectez le serveur MCP sans clé ni compte.

La même API existe pour chaque Présence IA construite avec Weftd. Un space privé exige une clé d'API, créée dans les réglages « Developer API » de ce space et envoyée en Authorization: Bearer <clé> ou X-API-Key: <clé>.

Endpoint : GET /api/v1

Posez une question à Weftd. POST /api/v1 accepte les mêmes champs dans un corps JSON.

ParamètreRequisValeursDescription
queryouitexteLa question, en langage naturel.
modenoncontext (défaut), searchcontext : une réponse rédigée par l'IA, avec ses sources. search : les entrées de connaissance classées par pertinence, sans IA.
typenontxt (défaut), jsonTexte brut ou JSON structuré.
limitnon1–50, 4 par défautNombre maximal d'entrées utilisées ou renvoyées.

Exemples de requêtes

Entrées classées, en JSON
curl "https://weftd.weftd.space/api/v1?query=Combien%20co%C3%BBte%20Weftd%20%3F&mode=search&type=json&limit=2"
Une réponse rédigée par l'IA, avec ses sources
curl -X POST https://weftd.weftd.space/api/v1 \
  -H "Content-Type: application/json" \
  -d '{"query": "Qu’est-ce qu’une Présence IA ?", "mode": "context", "type": "json"}'
Réponse (mode=search, type=json)
{
  "results": [
    { "id": "…", "title": "Weftd Plans and Pricing: Free to Enterprise", "snippet": "Weftd starts for free…", "relevance": 0.011 }
  ],
  "total": 1,
  "query": "Combien coûte Weftd ?"
}

Erreurs et limites de débit

Les erreurs sont en JSON, avec un champ error et, si utile, un code et un message : 400 pour une query absente ou une limit hors de 1–50, 403 pour un space privé sans clé valide, 404 pour un chemin inconnu, 429 quand la limite de débit est atteinte.

Les requêtes sont limitées par adresse IP. Chaque réponse porte les en-têtes RateLimit de l'IETF : RateLimit-Policy donne le quota et sa fenêtre, RateLimit les requêtes restantes et les secondes avant la remise à zéro. Un 429 porte en plus Retry-After : attendez ce nombre de secondes avant de réessayer.

Versions et dépréciation

La version est dans le chemin : /api/v1. Les évolutions qui ne cassent aucune requête existante (un nouveau paramètre optionnel, un nouveau champ de réponse) arrivent dans la v1. Un changement incompatible arrive sous un nouveau chemin, /api/v2, et la v1 continue de répondre.

Une version en fin de vie l'annonce sur chaque réponse : un en-tête Deprecation (RFC 9745), un en-tête Sunset (RFC 8594) avec sa date de retrait, au moins six mois à l'avance, et un en-tête Link rel="successor-version" vers la version qui la remplace. Le document OpenAPI énonce la même politique dans x-api-lifecycle.

Connecter le serveur MCP

Ajoutez https://weftd.weftd.space/mcp à votre assistant comme connecteur personnalisé. L'assistant peut alors chercher dans la connaissance de Weftd et envoyer un message à l'équipe.

Claude Code
claude mcp add --transport http weftd https://weftd.weftd.space/mcp
Tout client MCP (configuration JSON)
{
  "mcpServers": {
    "weftd": { "type": "http", "url": "https://weftd.weftd.space/mcp" }
  }
}

Fichiers lisibles par les machines