Главная/Документация

Документация API

Простой REST API из двух методов: /create — отправить капчу, /result — забрать ответ. Авторизация заголовком X-API-Key. Базовый URL — https://api.glidercap.com.

Начало работы

Работа с Glidercap строится в два шага: вы создаёте задачу (отправляете изображение капчи) и затем опрашиваете результат по её идентификатору. Подключение занимает около 5 минут.

Зарегистрируйтесь и получите API-ключ в личном кабинете.
Отправьте капчу методом POST /create — в ответ придёт id задачи.
Опрашивайте POST /result с этим id, пока не вернётся ответ (status: 1). Решаем быстро — опрашивайте часто: SmartCaptcha каждые 0,3–0,4 сек, текстовую каждые 0,2 сек.

💡

Единый простой контракт. Всего два метода — /create и /result, авторизация заголовком X-API-Key, тело и ответ — JSON. Совместим с популярными клиентами решения капчи.

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

Все запросы авторизуются API-ключом в заголовке X-API-Key:

HEADERX-API-Key: YOUR_API_KEY

Ключ привязан к балансу аккаунта. Получите его в личном кабинете и храните на стороне сервера — не публикуйте в клиентском коде.

Создать задачу

POSThttps://api.glidercap.com/create

Отправляет изображение(я) капчи в обработку. Тело — JSON, обязателен заголовок X-API-Key. В ответ приходит идентификатор задачи в поле response.

{
  "type": "SmartCaptcha",
  "click": "BASE64_картинки_с_заданием",
  "task": "BASE64_картинки_капчи"
}

{
  "type": "TextCaptcha",
  "task": "BASE64_картинки_капчи"
}

{ "status": 1, "response": "9051d4b4-0000-44d3-a4c2-db0215227862" }

Получить результат

POSThttps://api.glidercap.com/result

Передайте id из ответа на /create. Опрашивайте часто — SmartCaptcha каждые 0,3–0,4 сек (решение ~0,2 с), текстовую каждые 0,2 сек (решение ~10 мс): пока капча решается — вернётся CAPCHA_NOT_READY, при готовности — status: 1 и ответ в поле response.

{ "id": "9051d4b4-0000-44d3-a4c2-db0215227862" }

{
  "status": 1,
  "response": "coordinates:x=34,y=108;x=234,y=72;x=149,y=107;"
}

{
  "status": 1,
  "response": "распознанный текст"
}

{ "status": 0, "response": "CAPCHA_NOT_READY" }

⚡

Не хотите опрашивать в цикле? Используйте POST /result_wait с тем же телом — он держит соединение и вернёт ответ, как только капча решена (до ~20 секунд).

Параметры запроса

Поле	Тип	Описание
`type` обязательно	string	Тип капчи: `"SmartCaptcha"` или `"TextCaptcha"`.
`task` обязательно	string	Изображение капчи в base64 (основная картинка с заданием).
`click`	string	Только для SmartCaptcha — картинка-подсказка с заданием (что нужно нажать), base64.
`id` обязательно	string	Только для `/result` — идентификатор задачи из ответа `/create`.

Типы капч

type	Что возвращает	Точность	Цена
`SmartCaptcha`	Координаты точек для клика: `coordinates:x=..,y=..;`	99,7%	1,8 ₽ / 1000
`TextCaptcha`	Распознанный текст строкой (цифры, кириллица, латиница)	99,9%	бесплатно

Ответы и коды ошибок

Ответ всегда содержит status (1 — успех, 0 — ошибка либо ещё не готово) и response. При ошибке в response — её код:

response	Что значит
`ERROR_KEY_DOES_NOT_EXIST`	Неверный или отсутствующий API-ключ.
`MISSING_IMAGES`	Не переданы обязательные изображения (`task` / `click`).
`UNSUPPORTED_TYPE`	Неизвестное значение поля `type`.
`CAPCHA_NOT_READY`	Капча ещё решается — повторите `/result` через 0,2–0,4 секунды.

Примеры кода

Полный цикл «создать → дождаться → забрать» на популярных языках:

# 1. Создать задачу
curl -X POST https://api.glidercap.com/create \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"SmartCaptcha","click":"BASE64...","task":"BASE64..."}'
# → {"status":1,"response":"9051d4b4-..."}

# 2. Забрать результат
curl -X POST https://api.glidercap.com/result \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"id":"9051d4b4-..."}'
# → {"status":1,"response":"coordinates:x=34,y=108;..."}

import requests, time, base64

API = "YOUR_API_KEY"
H = {"X-API-Key": API}

task = base64.b64encode(open("captcha.png", "rb").read()).decode()
r = requests.post("https://api.glidercap.com/create", headers=H,
    json={"type": "TextCaptcha", "task": task}).json()
cid = r["response"]

while True:
    res = requests.post("https://api.glidercap.com/result", headers=H,
        json={"id": cid}).json()
    if res["status"] == 1:
        print(res["response"]); break
    time.sleep(0.2)

const API = "YOUR_API_KEY";
const H = { "X-API-Key": API, "Content-Type": "application/json" };

const create = await (await fetch("https://api.glidercap.com/create", {
  method: "POST", headers: H,
  body: JSON.stringify({ type: "SmartCaptcha", click: "BASE64...", task: "BASE64..." })
})).json();
const id = create.response;

// опрашиваем /result, пока status !== 1
const res = await (await fetch("https://api.glidercap.com/result", {
  method: "POST", headers: H, body: JSON.stringify({ id })
})).json();
console.log(res.response);

🛟

Нужна помощь с интеграцией? Напишите нам в Telegram — поможем подключиться.

Подключите API за 5 минут

Получите ключ в личном кабинете и отправьте первую капчу прямо сегодня.

Получить API-ключ Написать в Telegram