</> Remarka Connect · для разработчиков
Документация Remarka Connect
Два способа интеграции заказа переводов: MCP-сервер для ИИ-агентов и REST API для сайтов, CRM, 1С и Shopify. Адреса стабильны; при изменениях бюро уведомит.
MCP-сервер (для ИИ-агентов)
Подключается как пользовательский коннектор; авторизация агента не требуется
Инструменты:
| Инструмент | Назначение |
|---|---|
| remarka_get_catalog | Языковые пары и услуги бюро |
| remarka_calculate_price | Расчёт стоимости |
| remarka_estimate_deadline | Оценка срока |
| remarka_analyze_document | Объём и язык файла |
| remarka_create_order | Создание заказа |
| remarka_check_order_status | Статус заказа по номеру |
| remarka_download_result | Готовый переведённый файл |
Проверка подключения: npx @modelcontextprotocol/inspector → Transport: Streamable HTTP → URL выше → Connect → List Tools.
REST API (WordPress / CRM / 1С / Shopify)
JSON; цены — в копейках (делить на 100 → рубли)
| Метод и путь | Назначение |
|---|---|
| GET /catalog | Языковые пары + услуги |
| POST /calculate | Цена: {pages|chars, language_pair, certification, urgency} |
| POST /estimate-deadline | Срок: {pages, urgency} |
| POST /analyze | Анализ файла (multipart: file) |
| POST /upload | Загрузка файлов к заказу (multipart) |
| POST /orders | Создать заказ: {contact:{name,email,phone}, title, comment, language_pair, service_type, deadline} |
| GET /orders/{id} | Статус заказа |
| GET /orders/{id}/result | Готовый файл |
Значения параметров
| certification | none · stamp (печать бюро) · notary (нотариус) · apostille |
| urgency | normal · urgent · very_urgent |
| language_pair | код вида "ru-en", "en-it" (см. /catalog) |
Пример: расчёт цены
curl -X POST https://tms.perevod4.ru/api/v1/public/calculate \ -H "X-API-Key: <ключ>" -H "Content-Type: application/json" \ -d '{"pages": 10, "language_pair": "ru-en", "certification": "notary", "urgency": "urgent"}'Поведение
- Идемпотентность: при создании заказа передайте
Idempotency-Key: <строка>— повторный запрос с тем же ключом вернёт исходный заказ, а не создаст дубль. - Лимиты (на ключ): чтение — 60/мин, запись — 20/мин, анализ файлов — 12/мин. При превышении —
429. - Ошибки: машиночитаемые, вида
{"detail": {"code": "...", "message": "..."}}(напр.code: "volume_required").
API-ключ бюро держите только на стороне сервера интеграции — не публикуйте его в коде страницы или во фронтенде. Адрес MCP-сервера (mcp.perevod4.ru/mcp) публиковать можно — он для того и предназначен.