FR
Décrivez votre besoin

API et MCP pour les partenaires

Confiez-moi des tâches directement depuis vos logiciels et vos assistants IA : envoyez la tâche, recevez un prix et un délai, acceptez, et je commence le travail. La même API donne accès au catalogue de mes 8 services.

Commander via l’API

Aucune clé d’API n’est nécessaire. Une nouvelle commande renvoie un numéro et une clé de commande : ils servent à lire le statut et à répondre. Les mêmes actions sont disponibles via MCP avec les outils create_order, get_order et order_action.

  1. Vous envoyez la tâche : POST /api/orders. Statut : received.
  2. Je lis la tâche et j’inscris un prix et un délai dans la commande. Statut : quoted.
  3. Vous acceptez le prix (accept avec le numéro du devis, quote_id), vous le refusez (decline) ou vous posez une question (message).
  4. Une fois le devis accepté, je commence le travail : statut in_work, puis delivered avec un lien vers le résultat.
  5. Vous validez le travail (approve), statut closed, ou vous le renvoyez avec des remarques (revision) : la commande repasse en in_work.
POST /api/ordersNouvelle commande. Obligatoires : task (jusqu’à 4000 caractères), contact et consent: true. Facultatifs : title, partner, ref (votre propre numéro de tâche), deadline, budget, service, links (jusqu’à 5 liens https), lang, callback_url, idempotency_key.
GET /api/orders/{id}Statut, prix et délai (quote), résultats (deliverables), événements, étapes possibles à ce stade (actions) et indication de la suite (next). Nécessite l’en-tête Authorization: Bearer avec la clé de commande.
POST /api/orders/{id}Votre étape : action - accept (nécessite quote_id, repris de quote.id), decline, cancel, approve, revision ou message ; message et revision exigent un texte. Même en-tête.
curl -X POST 'https://fastdev24.com/api/orders' \
  -H 'Content-Type: application/json' \
  --data '{"task":"Landing page pour un cabinet dentaire : 5 sections, formulaire de contact, textes fournis.","contact":"dev@example.com","consent":true,"ref":"TASK-17","idempotency_key":"<random-hex-64>","links":["https://example.com/brief.pdf"]}'
curl 'https://fastdev24.com/api/orders/ORDER_ID' -H 'Authorization: Bearer ORDER_KEY'
curl -X POST 'https://fastdev24.com/api/orders/ORDER_ID' \
  -H 'Authorization: Bearer ORDER_KEY' -H 'Content-Type: application/json' \
  --data '{"action":"accept","quote_id":"QUOTE_ID"}'

Pour être averti des changements de la commande, indiquez callback_url : j’envoie en POST le numéro, le statut et le prix à cette adresse à chaque mise à jour de la commande. La requête est signée avec la clé de commande (en-tête X-Order-Signature) et fait l’objet de deux tentatives d’envoi ; si votre adresse ne répond pas, vous pouvez toujours lire l’état avec GET. Pour qu’un nouvel envoi de la commande ne crée pas de doublon, indiquez idempotency_key, votre propre chaîne aléatoire d’au moins 16 caractères : un nouvel envoi avec cette clé renvoie la même commande.

Catalogue des services

Lecture seule, sans clé d’API. Le paramètre lang fixe la langue de la réponse : ru, pl, en, de, es ou fr (par défaut : en). Les réponses sont en JSON avec un ETag et sont mises en cache 5 minutes.

GET /api/services?lang=frListe des services : numéro, slug, groupe, titre, résultat, délai et prix lorsqu’ils sont publiés.
GET /api/services/{id}?lang=frUn service par son numéro 1-8 ou son slug, par exemple web-design : contenu, ce dont j’ai besoin de votre part, vérifications, validation, questions fréquentes.
GET /openapi.jsonSpécification OpenAPI 3.1 de l’API.
curl 'https://fastdev24.com/api/services/web-design?lang=fr'

Serveur MCP

Point d’accès : https://fastdev24.com/mcp. Transport Streamable HTTP sans état (sans sessions) : version du protocole 2026-07-28 et versions antérieures avec initialize 2025-11-25, 2025-06-18. Les réponses sont en JSON simple ; il n’y a pas de flux SSE en GET.

Outils

  • list_services - liste des services dans la langue choisie, avec filtre par groupe si besoin
  • get_service - détail complet d’un service
  • create_request - une demande pour moi : coordonnées, description du besoin jusqu’à 600 caractères et acceptation de la politique de confidentialité
  • create_order - une nouvelle commande : tâche, contact et consentement ; renvoie le numéro et la clé de commande
  • get_order - statut de la commande, prix et délai, résultats, événements
  • order_action - accepter le prix, le refuser, annuler la commande, valider le travail, le renvoyer pour correction ou envoyer un message

Comment se connecter

Dans un client compatible avec les serveurs MCP distants, ajoutez un serveur avec le point d’accès ci-dessus. Exemple pour Claude Code (.mcp.json) :

{
  "mcpServers": {
    "fastdev24": {
      "type": "http",
      "url": "https://fastdev24.com/mcp"
    }
  }
}

Exemple en ligne de commande : afficher la liste des outils. Pour la version 2026-07-28, indiquez la version du protocole et les capacités du client dans _meta :

curl -X POST 'https://fastdev24.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/list' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

Limites

  • Nouvelles commandes : environ 20 par heure et par adresse IP, et environ 100 par jour au total. Corps de la requête : jusqu’à 32 Ko pour une nouvelle commande, 16 Ko pour une étape. Par commande : jusqu’à 60 étapes par heure et 20 messages par jour. Conservez la clé de commande : sans elle, la commande ne peut pas être lue. Les commandes sont conservées 180 jours après la dernière modification. Laissez quelques minutes entre deux consultations du statut. Si un résultat livré reste sans réponse pendant 7 jours, je clôture la commande.
  • Les limites des demandes sont indicatives : environ 10 par heure via le formulaire et 30 via MCP par adresse IP, et environ 60 par jour au total. Elles peuvent être dépassées en cas de panne ou de requêtes simultanées.
  • N’envoyez une demande qu’après l’accord explicite de la personne : les coordonnées et le besoin m’arrivent exactement comme s’ils étaient envoyés par le formulaire du site.
  • Les appels d’outils MCP sont limités à environ 60 par minute, par adresse IP et par instance du serveur. Taille maximale du corps de la requête : 64 Ko pour MCP et 16 Ko pour le formulaire.
  • Les réponses de l’API comprennent 400 (bad_lang, bad_group), 404 (not_found) et 304 lorsque l’ETag correspond. Les erreurs de saisie de create_request renvoient isError avec une explication.
  • Le catalogue est mis à jour en même temps que le site ; une nouvelle valeur de version ou un nouvel ETag pour la même ressource et la même langue signifie que les données ou le format de réponse ont changé.