RU
Написать задачу

API и MCP для партнёров

Передавайте мне задачи из своих программ или через своего помощника: отправили задачу - получили цену и срок - согласились - я начал работу. Тот же API отдаёт каталог моих 8 услуг.

Заказ по API

Ключ API не нужен. В ответ на новый заказ приходят номер заказа и ключ заказа: с ними вы читаете статус и отвечаете. Через MCP то же самое делают инструменты create_order, get_order и order_action.

  1. Вы отправляете задачу: POST /api/orders. Статус received.
  2. Я читаю задачу и ставлю в заказ цену и срок. Статус quoted.
  3. Вы принимаете цену (accept с номером цены quote_id), отказываетесь (decline) или задаёте вопрос (message).
  4. После accept я начинаю работу: статус in_work, затем delivered со ссылкой на результат.
  5. Вы принимаете работу (approve) - статус closed, или возвращаете её с замечаниями (revision) - заказ снова in_work.
POST /api/ordersНовый заказ. Обязательны task (до 4000 знаков), contact и consent: true. По желанию: title, partner, ref (ваш номер задачи), deadline, budget, service, links (до 5 ссылок https), lang, callback_url, idempotency_key.
GET /api/orders/{id}Статус, цена и срок (quote), результаты (deliverables), события, доступные шаги (actions) и подсказка next: что делать дальше. Нужен заголовок Authorization: Bearer с ключом заказа.
POST /api/orders/{id}Ваш шаг: action - accept (нужен quote_id из quote.id), decline, cancel, approve, revision или message; для message и revision нужен text. Тот же заголовок.
curl -X POST 'https://fastdev24.com/api/orders' \
  -H 'Content-Type: application/json' \
  --data '{"task":"Landing page for a dental clinic: 5 sections, enquiry form, texts attached.","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"}'

Чтобы узнавать об изменениях заказа без опроса, передайте callback_url: при каждом своём шаге я отправляю на этот адрес POST с номером заказа, статусом и ценой. Запрос подписан ключом заказа (заголовок X-Order-Signature), попыток две; если ваш адрес не ответил, состояние всегда можно прочитать запросом GET. Чтобы повтор запроса не создал второй заказ, передайте idempotency_key - свою случайную строку не короче 16 знаков: повтор с ней вернёт тот же заказ.

Каталог услуг

Только чтение, без ключа API. Язык ответа - параметр lang: ru, pl, en, de, es или fr (по умолчанию en). Ответ - JSON с заголовком ETag, кэшируется на 5 минут.

GET /api/services?lang=ruСписок услуг: номер, slug, группа, название, результат, срок и цена, если она опубликована.
GET /api/services/{id}?lang=ruОписание услуги по номеру 1-8 или slug, например web-design: состав, что нужно от вас, проверка, приёмка, вопросы.
GET /openapi.jsonОписание API в формате OpenAPI 3.1.
curl 'https://fastdev24.com/api/services/web-design?lang=ru'

Сервер MCP

Адрес - https://fastdev24.com/mcp. Транспорт Streamable HTTP без сессий: версия протокола 2026-07-28 и прежние версии с initialize - 2025-11-25, 2025-06-18. Ответы - обычный JSON, потока SSE через GET нет.

Инструменты

  • list_services - список услуг на выбранном языке, можно по группе
  • get_service - полное описание одной услуги
  • create_request - заявка мне: контакт, задача до 600 знаков и согласие с политикой конфиденциальности
  • create_order - новый заказ: задача, контакт и согласие; в ответ номер и ключ заказа
  • get_order - статус заказа, цена и срок, результаты, события
  • order_action - принять цену, отказаться, отменить заказ, принять работу, вернуть на правки или написать сообщение

Как подключить

В клиенте, который поддерживает удалённые серверы MCP, добавьте сервер с адресом выше. Пример для Claude Code (.mcp.json):

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

Проверка из командной строки - список инструментов. В запросах версии 2026-07-28 передайте в _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":{}}}}'

Ограничения

  • Новых заказов - около 20 в час с IP-адреса и около 100 в сутки всего. Тело запроса заказа - до 32 КБ, шага - до 16 КБ. По одному заказу - до 60 шагов в час и до 20 сообщений в сутки. Ключ заказа храните у себя: без него заказ не прочитать. Заказ хранится 180 дней после последнего изменения. Статус опрашивайте не чаще раза в несколько минут. Если на сдачу нет ответа 7 дней, я закрываю заказ.
  • Лимиты заявок ориентировочные: около 10 в час с формы и около 30 через MCP на IP-адрес, всего около 60 в сутки. При сбоях и одновременных запросах они могут не сработать.
  • Заявку отправляйте только после явного согласия человека: контакт и задача приходят мне так же, как с формы сайта.
  • Вызовы инструментов MCP - около 60 в минуту на IP-адрес в пределах одного экземпляра сервера. Тело запроса MCP - до 64 КБ, заявки с формы - до 16 КБ.
  • Ответы API: 400 (bad_lang, bad_group), 404 (not_found), 304 - если ETag совпал. Ошибки create_request приходят результатом с isError и объяснением.
  • Каталог меняется вместе с сайтом; новое значение поля version или ETag того же ресурса и языка означает, что данные или формат ответа обновились.