Перейти до основного вмісту
У цьому документі буде представлено опис інтеграції API для розпізнавання цифрових англійських капч, який базується на технології глибокого навчання і може використовуватися для розпізнавання змінних англійських цифрових капч. Вхідні дані - зображення капчі, вихідні дані - результат розпізнавання капчі.

​
Процес подачі заявки

Щоб використовувати API, спочатку потрібно перейти на сторінку API для розпізнавання цифрових англійських капч і подати заявку на відповідну послугу. Після переходу на сторінку натисніть кнопку «Acquire», як показано на малюнку: Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід. Після входу або реєстрації ви автоматично повернетеся на поточну сторінку. При першій подачі заявки вам буде надано безкоштовний ліміт, який дозволяє безкоштовно використовувати цей API.

​
Основне використання

Спочатку розглянемо основний спосіб використання, а саме, введіть зображення змінної англійської цифрової капчі, щоб отримати оброблений результат. Спочатку потрібно просто передати поле image, яке є конкретним зображенням англійської цифрової капчі, як показано на малюнку:

Потім нам потрібно перетворити зображення капчі в Base64-кодоване зображення капчі. Для перетворення Base64-коду рекомендується використовувати плагін Google Chrome FeHelper, детальніше про використання можна ознайомитися на наступному малюнку:

Після цього ви можете скопіювати Base64-код, отриманий за допомогою плагіна FeHelper, пам’ятайте, що він не містить префікса data:image/png;base64, конкретний вміст виглядає так:

Ми можемо бачити, що тут ми налаштували заголовки запиту, включаючи:
  • accept: формат відповіді, який ви хочете отримати, тут вказано application/json, тобто формат JSON.
  • authorization: ключ для виклику API, після подачі заявки ви можете вибрати його зі списку.
Крім того, налаштовано тіло запиту, яке включає:
  • image: Base64-кодоване зображення капчі (без префікса data:image/png;base64).
Після вибору ви можете помітити, що праворуч також згенеровано відповідний код, як показано на малюнку:

Натисніть кнопку «Try», щоб провести тестування, як показано на малюнку, тут ми отримали наступний результат: 
{
  "text": "7364"
}
У повернутому результаті є кілька полів, описаних нижче:
  • text: текстовий вміст, отриманий після обробки завдання зображення змінної англійської цифрової капчі.
Ми можемо бачити, що отримали результат перевірки обробленого зображення змінної англійської цифрової капчі, нам потрібно лише перевірити текстовий вміст поля text, щоб пройти перевірку. Крім того, якщо ви хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код CURL виглядає так: 
curl -X POST 'https://api.acedata.cloud/captcha/recognition/image2text' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..."
}'
Код інтеграції на Python виглядає так: 
import requests

url = "https://api.acedata.cloud/captcha/recognition/image2text"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..."
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Обробка помилок

При виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:
  • 400 token_mismatched: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 400 api_not_implemented: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 401 invalid_token: Неавторизовано, недійсний або відсутній токен авторизації.
  • 429 too_many_requests: Занадто багато запитів, ви перевищили ліміт запитів.
  • 500 api_error: Внутрішня помилка сервера, щось пішло не так на сервері.

​
Приклад відповіді з помилкою

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Висновок

Завдяки цьому документу ви дізналися, як використовувати API для розпізнавання цифрових англійських капч, який може бути використаний для розпізнавання змінних англійських цифрових капч. Введіть зображення капчі, щоб отримати результат розпізнавання. Сподіваємося, що цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.