Вызвать метод

Вызов ставит задачу аккаунту и сразу возвращает её номер. Результат вы забираете по этому номеру — опросом или одним долгим запросом.

Передать ключ

Ключ идёт в заголовке каждого запроса:

Authorization: Bearer igrm_…

Метод сработает, только если у ключа есть нужное право. Адрес API и готовые примеры — во вкладке Документация раздела API.

Вызвать

Каждый метод — свой адрес: POST /api/v1/public/methods/<метод>. В теле — account_id, от чьего имени действовать, и параметры метода.

POST /api/v1/public/methods/resolve_username
{"account_id": "…", "username": "coffee_lab_demo"}

В ответ — job_id, номер задачи.

Забрать результат

GET /api/v1/public/jobs/<job_id> отвечает статусом задачи, а когда она готова — результатом в поле result или ошибкой в поле error.

Чтобы не опрашивать в цикле, добавьте ?wait=30: запрос подождёт до 30 секунд и ответит, как только задача завершится.

Результат хранится 7 дней.

Какой аккаунт

Только аккаунт из вашего пакета. Вызов отклоняется сразу, если аккаунт заблокирован Telegram или пакет не оплачен. Метод тратит суточный лимит аккаунта на это действие, и ограничения аккаунта действуют для API так же, как в кабинете.