Авторизация

Публичный API

Версия v1 • Аутентификация по заголовку X-API-Key

Аутентификация

Получите персональный API‑ключ в настройках профиля. Передавайте его в заголовке X-API-Key в каждом запросе.

curl -H "X-API-Key: ak_xxxxxxxxxxxxxxxxx" https://akysos.market/api/v1/telegram/verify

Ограничения по умолчанию: до 120 запросов/минуту на ключ и IP.

POST /api/v1/telegram/upload

Извлечение authkey:dcid из загруженных файлов или строковых сессий.

multipart/form-data 
curl -X POST \
  -H "X-API-Key: ak_..." \
  -F "files[]=@/path/to/session" \
  -F "files[]=@/path/to/tdata.zip" \
  https://akysos.market/api/v1/telegram/upload
application/json 
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_..." \
  -d '{"sessions":["<telethon_string_session>",{"string":"<pyrogram_or_telethon>"}]}' \
  https://akysos.market/api/v1/telegram/upload

Ответ:

{
  "success": true,
  "mode": "files|json",
  "results": [
    {"filename":"...","key":"<authkey:dcid>","success":true},
    {"index":0,"success":false,"error":"unrecognized"}
  ]
}

POST /api/v1/telegram/verify

Быстрая проверка структуры tdata (файлы zip или путь на сервере).

curl -X POST -H "X-API-Key: ak_..." -F "files[]=@/path/to/tdata.zip" https://akysos.market/api/v1/telegram/verify
curl -X POST -H "Content-Type: application/json" -H "X-API-Key: ak_..." \
  -d '{"path":"/abs/path/to/tdata"}' https://akysos.market/api/v1/telegram/verify

Ответ (пример):

{
  "success": true,
  "mode": "files",
  "results": [
    {"filename":"tdata.zip","success":true,"status":"OK","found":{"key_data":true,...}}
  ]
}

POST /api/v1/telegram/publish

Подготовка к публикации аккаунтов Telegram. Принимает поля, совместимые с веб‑формой:

  • account_list — строки сессий (по одной на строку)
  • title, price, origin|style, is_resell, was_used_in_services
  • mark, seller_comment, info_for_buyers
curl -X POST -H "X-API-Key: ak_..." \
  -F "account_list=$(printf "sess1\nsess2\n")" \
  -F "title=TG pack" -F "price=100" -F "origin=FISHING" \
  https://akysos.market/api/v1/telegram/publish

Ответ:

{
  "success": true,
  "session_key": "<key>",
  "skipped": [...],
  "valid_accounts": ["..."]
}

Дальнейшее завершение публикации выполняется через метод POST /api/v1/telegram/publish/finalize (см. ниже). Аккаунты, которые уже находятся на продаже, не публикуются повторно и возвращаются в списке пропусков.

POST /api/v1/telegram/publish/finalize

Финализация публикации ранее подготовленного батча. Ожидает завершения проверки (статус сессии COMPLETED) и создаёт объявления.

application/json 
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_..." \
  -d '{"session_key":"<session_key>"}' \
  https://akysos.market/api/v1/telegram/publish/finalize

Ответ (пример):

{
  "success": true,
  "published": [{"raw":"...","id":12345}],
  "skipped": [{"raw":"...","reason":"already_on_sale","account_id":678}],
  "errors": []
}

Если аккаунт уже находится на продаже (активен/закрыт), он не будет опубликован повторно. Сессионный ключ можно получить на этапе подготовки публикации.

Ошибки

  • 401 — отсутствует/неверный API‑ключ
  • 429 — превышен лимит запросов
  • 400 — формат запроса невалиден
© Akysos Market