API и MCP для партнёров
Передавайте мне задачи из своих программ или через своего помощника: отправили задачу - получили цену и срок - согласились - я начал работу. Тот же API отдаёт каталог моих 8 услуг.
Заказ по API
Ключ API не нужен. В ответ на новый заказ приходят номер заказа и ключ заказа: с ними вы читаете статус и отвечаете. Через MCP то же самое делают инструменты create_order, get_order и order_action.
- Вы отправляете задачу: POST /api/orders. Статус received.
- Я читаю задачу и ставлю в заказ цену и срок. Статус quoted.
- Вы принимаете цену (accept с номером цены quote_id), отказываетесь (decline) или задаёте вопрос (message).
- После accept я начинаю работу: статус in_work, затем delivered со ссылкой на результат.
- Вы принимаете работу (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 того же ресурса и языка означает, что данные или формат ответа обновились.