README

Modern PHP SDK for the AntiCaptcha API. Built with provider-agnostic contracts so additional captcha providers can be added without changing consumer code.

Requirements

• PHP >=7.1.2
• ext-curl
• ext-json

No third-party runtime dependencies.

Installation

composer require anticaptcha/sdk

Quick start

<?php

declare(strict_types=1);

use AntiCaptcha\Sdk\AntiCaptcha\AntiCaptchaClient;
use AntiCaptcha\Sdk\AntiCaptcha\AntiCaptchaConfig;
use AntiCaptcha\Sdk\Http\CurlHttpClient;
use AntiCaptcha\Sdk\Support\TaskPoller;
use AntiCaptcha\Sdk\Task\RecaptchaV2ProxylessTask;

$config = new AntiCaptchaConfig('YOUR_API_KEY');
$client = new AntiCaptchaClient($config, new CurlHttpClient(), new TaskPoller());

$task = new RecaptchaV2ProxylessTask('https://example.com', 'SITE_KEY');
$result = $client->solve($task);

echo $result->getGRecaptchaResponse();

Supported task types (v1)

API methods

The AntiCaptchaClient implements CaptchaClientInterface:

• createTask(TaskInterface $task): TaskCreationResult
• getTaskResult(int $taskId): TaskResult
• solve(TaskInterface $task): TaskResult — create + poll until ready
• getBalance(): float
• reportIncorrectRecaptcha(int $taskId): void

Configuration

AntiCaptchaConfig accepts:

Error handling

API errors (errorId > 0) are mapped to typed exceptions:

• ERROR_KEY_DOES_NOT_EXIST → AuthenticationException
• ERROR_ZERO_BALANCE → InsufficientBalanceException
• Other codes → ApiException
• Network/cURL failures → NetworkException
• Polling timeout → TimeoutException

Architecture

Contracts (provider-agnostic)
  ├── CaptchaClientInterface
  ├── TaskInterface
  └── HttpClientInterface

AntiCaptcha provider
  ├── AntiCaptchaClient
  ├── AntiCaptchaApi
  └── Task value objects

Infrastructure
  ├── CurlHttpClient
  ├── TaskPoller
  └── ResponseParser

Inject a custom HttpClientInterface implementation for testing or alternative transports.

Development

composer install
vendor/bin/phpunit

License

MIT — see LICENSE.