Документация для разработчиковСправочник API
Обзор
Базовый URL, соглашения и все endpoints.
https://runner.cargoduo.com/v1JSON поверх HTTPS. Длины — в cm, вес — в kg, деньги — в кредитах.
Endpoints
Расчёт загрузки
| Endpoint | Страница | Область доступа |
|---|---|---|
POST /v1/pack | Создать задание на расчёт загрузки | pack:write |
POST /v1/estimate | Оценить стоимость задания | pack:write |
Задания
| Endpoint | Страница | Область доступа |
|---|---|---|
GET /v1/jobs | Список заданий | jobs:read |
GET /v1/jobs/{id} | Получить задание | jobs:read |
GET /v1/jobs/{id}/result | Получить результат задания | jobs:read |
DELETE /v1/jobs/{id} | Отменить задание | pack:write |
Проекты
| Endpoint | Страница | Область доступа |
|---|---|---|
GET /v1/projects | Список проектов | resources:read |
POST /v1/projects | Создать проект | resources:write |
GET /v1/projects/{id} | Получить проект | resources:read |
PATCH /v1/projects/{id} | Изменить проект | resources:write |
DELETE /v1/projects/{id} | Удалить проект | resources:write |
POST /v1/projects/{id}/pack | Рассчитать загрузку проекта | pack:write и resources:write |
Транспорт
| Endpoint | Страница | Область доступа |
|---|---|---|
GET /v1/vehicles | Список транспортных средств | resources:read |
GET /v1/vehicles/{id} | Получить транспортное средство | resources:read |
POST /v1/vehicles | Создать транспортное средство | resources:write |
PATCH /v1/vehicles/{id} | Изменить транспортное средство | resources:write |
DELETE /v1/vehicles/{id} | Удалить транспортное средство | resources:write |
Шаблоны
| Endpoint | Страница | Область доступа |
|---|---|---|
GET /v1/templates | Список шаблонов | resources:read |
GET /v1/templates/{id} | Получить шаблон | resources:read |
POST /v1/templates | Создать шаблон | resources:write |
PATCH /v1/templates/{id} | Изменить шаблон | resources:write |
DELETE /v1/templates/{id} | Удалить шаблон | resources:write |
Аккаунт
| Endpoint | Страница | Область доступа |
|---|---|---|
GET /v1/limits | Получить лимиты | account:read |
GET /v1/balance | Получить баланс | account:read |
GET /v1/usage | Получить статистику использования | account:read |
Заголовки
| Заголовок | Направление | Значение |
|---|---|---|
Authorization | Запрос | Bearer cd_live_… |
Content-Type | Запрос | application/json для POST |
Idempotency-Key | Запрос | Безопасные повторы POST /v1/pack и POST /v1/projects/{id}/pack |
X-Request-Id | Ответ | ID запроса (req_…), в каждом ответе |
X-RateLimit-Limit / -Remaining / -Reset | Ответ | Самое строгое окно лимита |
X-Credits-Remaining | Ответ | Доступные кредиты после запроса |
Retry-After | Ответ | При 429: сколько секунд ждать |
Idempotent-Replayed | Ответ | true, если по ключу возвращено ранее созданное задание |
Машиночитаемые файлы
openapi.jsonOpenAPI 3.1, все endpoints и схемы.llms-full.txtруководство по интеграции для ИИ-агентов, пишущих код.