API и автоматизация
Ключи, запросы, коды ошибок, фоновые задания и вебхуки: как получать данные сервиса в своих программах, скриптах и, в будущем, через CLI и MCP-сервер.
- 1Первый запрос к APIAPI отдаёт те же данные, что и кабинет, в формате JSON: подойдёт для скриптов, панелей и отчётов.
- 2Долгие операции и заданияПроверка и обход сайта занимают время, поэтому API отвечает сразу и выдаёт задание, за ходом которого можно следить.
- 3Ошибки, повторы и идемпотентностьОшибка API всегда содержит стабильный код. По нему программа решает, повторять запрос или исправить его.
Открыть в сервисе
Подробные руководства
API: руководство (версия 126)Обзор правил, общих для всех методов. Описание каждого метода с примерами — в справочнике «APIREFERENCE»; машиночитаемое — GET /api/v1/openapi.json; возможности для программ — GET /api/v1/capabilities .Справочник методов API (версия 126)Все методы API версии 1 . У каждого метода указаны право ключа, команда CLI и имя инструмента MCP: эти имена общие для CLI и MCP-сервера и не меняются. Общие правила — ошибки, постраничность, идемпотентность, задания, в