ES
Describa su tarea

API y MCP para partners

Encárgueme tareas directamente desde su software y sus asistentes de IA: envíe la tarea, reciba precio y plazo, acepte, y empiezo a trabajar. La misma API ofrece el catálogo de mis 8 servicios.

Pedidos por la API

No hace falta clave de API. Cada pedido nuevo devuelve un número y una clave del pedido: con ellos se consulta el estado y se responde. Las mismas acciones están disponibles por MCP con las herramientas create_order, get_order y order_action.

  1. Usted envía la tarea: POST /api/orders. Estado: received.
  2. Leo la tarea y añado al pedido el precio y el plazo. Estado: quoted.
  3. Usted acepta el precio (accept con el número de la oferta, quote_id), lo rechaza (decline) o hace una pregunta (message).
  4. Cuando acepta la oferta, empiezo a trabajar: estado in_work y después delivered, con un enlace al resultado.
  5. Usted aprueba el trabajo (approve) y el estado pasa a closed, o lo devuelve con observaciones (revision) y el pedido vuelve a in_work.
POST /api/ordersPedido nuevo. Obligatorios: task (hasta 4000 caracteres), contact y consent: true. Opcionales: title, partner, ref (su propio número de tarea), deadline, budget, service, links (hasta 5 enlaces https), lang, callback_url, idempotency_key.
GET /api/orders/{id}Estado, precio y plazo (quote), resultados (deliverables), eventos, los pasos disponibles ahora (actions) y una pista sobre el siguiente paso (next). Requiere la cabecera Authorization: Bearer con la clave del pedido.
POST /api/orders/{id}Su paso: action - accept (requiere quote_id de quote.id), decline, cancel, approve, revision o message; message y revision requieren text. La misma cabecera.
curl -X POST 'https://fastdev24.com/api/orders' \
  -H 'Content-Type: application/json' \
  --data '{"task":"Landing page para una clínica dental: 5 secciones, formulario de contacto, textos adjuntos.","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"}'

Para recibir un aviso cuando cambie el pedido, indique callback_url: envío por POST el número del pedido, el estado y el precio a esa dirección cada vez que actualizo el pedido. La petición va firmada con la clave del pedido (cabecera X-Order-Signature) y se envía hasta dos veces; si su dirección no responde, siempre puede leer el estado con GET. Para que un reintento sea seguro, indique idempotency_key, una cadena aleatoria propia de al menos 16 caracteres: un reintento con ella devuelve el mismo pedido.

Catálogo de servicios

Solo lectura, sin clave de API. El parámetro lang fija el idioma de la respuesta: ru, pl, en, de, es o fr (por defecto, en). Las respuestas son JSON con ETag y se guardan en caché 5 minutos.

GET /api/services?lang=esLista de servicios: número, slug, grupo, título, resultado, plazo y precio, cuando están publicados.
GET /api/services/{id}?lang=esUn servicio por número 1-8 o por slug, p. ej. web-design: alcance, qué necesito de usted, comprobaciones, aceptación y preguntas frecuentes.
GET /openapi.jsonEspecificación OpenAPI 3.1 de la API.
curl 'https://fastdev24.com/api/services/web-design?lang=es'

Servidor MCP

Punto de acceso: https://fastdev24.com/mcp. Transporte Streamable HTTP sin estado (sin sesiones): versión del protocolo 2026-07-28 y las versiones anteriores con initialize 2025-11-25, 2025-06-18. Las respuestas son JSON simple; no hay flujo SSE por GET.

Herramientas

  • list_services - lista de servicios en el idioma elegido, con filtro opcional por grupo
  • get_service - todos los datos de un servicio
  • create_request - una solicitud para mí: datos de contacto, descripción de la tarea de hasta 600 caracteres y aceptación de la política de privacidad
  • create_order - un pedido nuevo: tarea, contacto y consentimiento; devuelve el número y la clave del pedido
  • get_order - estado del pedido, precio y plazo, resultados, eventos
  • order_action - aceptar el precio, rechazarlo, cancelar el pedido, aprobar el trabajo, devolverlo para correcciones o enviar un mensaje

Cómo conectarse

En un cliente compatible con servidores MCP remotos, añada un servidor con el punto de acceso indicado arriba. Ejemplo para Claude Code (.mcp.json):

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

Ejemplo en la línea de comandos: lista de herramientas. Para la versión 2026-07-28, incluya en _meta la versión del protocolo y las capacidades del cliente:

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":{}}}}'

Límites

  • Pedidos nuevos: unos 20 por hora por dirección IP y unos 100 al día en total. Cuerpo de la petición: hasta 32 KB para un pedido nuevo y 16 KB para un paso. Por pedido: hasta 60 pasos por hora y 20 mensajes al día. Guarde la clave del pedido: sin ella el pedido no se puede consultar. Los pedidos se conservan 180 días desde el último cambio. Consulte el estado como mucho una vez cada pocos minutos. Si un resultado entregado queda 7 días sin respuesta, cierro el pedido.
  • Los límites de solicitudes son aproximados: unas 10 por hora por el formulario y 30 por MCP por IP, y unas 60 al día en total. Pueden no cumplirse durante fallos o con peticiones simultáneas.
  • Envíe una solicitud solo cuando la persona lo haya aceptado expresamente: el contacto y la tarea me llegan igual que si se enviaran por el formulario del sitio.
  • Las llamadas a herramientas MCP están limitadas a unas 60 por minuto por IP y por instancia del servidor. Tamaño máximo del cuerpo: 64 KB para MCP y 16 KB para el formulario.
  • Las respuestas de la API incluyen 400 (bad_lang, bad_group), 404 (not_found) y 304 cuando el ETag coincide. Los errores de entrada de create_request devuelven isError con una explicación.
  • El catálogo se actualiza junto con el sitio; un valor nuevo de version o de ETag para el mismo recurso e idioma significa que cambiaron los datos o el formato de la respuesta.