POST /captcha/tasks. Lorsque vous appelez n’importe quelle interface de captcha (série token ou série reconnaissance) en passant async: true, l’interface renverra immédiatement un task_id, le serveur prendra immédiatement en charge et continuera à traiter ; vous pouvez utiliser ce task_id pour interroger le résultat final, mais l’interrogation n’est pas une condition préalable à l’exécution continue de la tâche. Cela convient à des scénarios tels que la rotation de plusieurs solveurs (multi-solver rotation) : après avoir soumis la tâche, vous obtenez immédiatement le task_id, vous pouvez d’abord planifier d’autres solveurs, puis revenir plus tard pour lire les résultats.
📘 Documentation interactive complète (avec débogage en ligne) : API de requête de tâche de captcha →
Processus de demande
Pour utiliser cette interface, rendez-vous d’abord sur le tableau de bord Ace Data Cloud pour obtenir votre API Token, à conserver en réserve. Un API Token suffit pour appeler tous les services de la plateforme, il n’est pas nécessaire de demander un pour chaque service.Utilisation de base
Étape 1 : Créer une tâche de manière asynchrone
Dans le corps de la requête de n’importe quelle interface de captcha, passezasync: true, l’interface renverra immédiatement un task_id (HTTP 201), sans bloquer l’attente :
Étape 2 (facultatif) : Interroger le résultat avec task_id
Si vous souhaitez vérifier activement l’avancement, vous pouvez utiliser letask_id renvoyé à l’étape précédente pour interroger POST /captcha/tasks (il est conseillé de le faire toutes les 3 à 5 secondes). Cette interface ne déclenchera ni n’avancera le traitement de la tâche ; la lecture des résultats prêts suivra le comportement de règlement unique existant :
status: processing :
status: ready et le champ de résultat correspondant — la structure des champs est complètement identique à celle du mode synchrone :
- série token (hcaptcha, recaptcha2, recaptcha3) renvoie
token:
- classification de reconnaissance (recognition/recaptcha2, recognition/hcaptcha) renvoie
solution; recognition/image2text renvoietext.
/captcha/tasks est commun à toutes les interfaces de captcha (séries token et reconnaissance), vous pouvez interroger avec le même task_id.
Le serveur continue de traiter depuis sa création, pendant un maximum de 120 secondes. Si lors de la dernière interrogation avant la date limite, aucun résultat n’est obtenu, cela renverra un HTTP 504. Cet état est terminal, le client doit arrêter l’interrogation ; interroger plusieurs fois le même task_id renverra de manière stable le même résultat d’échec :
status: ready et HTTP 504 incluront également des champs de chronométrage.
started_at, heure de début du traitement de la tâche, horodatage Unix (secondes, flottant).finished_at, heure de production du résultat de la tâche, horodatage Unix (secondes, flottant). Ce champ ne sera pas renvoyé tant que le traitement est en cours.elapsed, temps de traitement de la tâche, en secondes (flottant, avec 3 décimales). Ce champ ne sera pas renvoyé tant que le traitement est en cours.
Informations de facturation
En mode asynchrone, la création de tâches et la lecture de l’état “en cours de traitement” ne sont pas facturées ; le client est facturé une fois lors de la première lecture réussie des résultats (identique au comportement existant et au prix du mode synchrone). Le serveur fera avancer la tâche de manière autonome, mais ne facturera pas à l’avance en raison d’une fin de traitement en arrière-plan. Les tâches qui n’ont pas réussi dans les 120 secondes de délai seront terminées par un HTTP 504 et ne seront pas facturées.Gestion des erreurs
Lors de l’appel de cette interface, si une erreur se produit, un code d’erreur et un message appropriés seront renvoyés. Par exemple :400 invalid_request: la requête manque du paramètretask_id.401 invalid_token: non autorisé, le token d’autorisation est invalide ou manquant.404 not_found:task_idn’existe pas ou n’appartient pas au compte actuel.504 timeout: la tâche a été terminée et n’a pas produit de résultat ; veuillez arrêter l’interrogation de cetask_id. Cet échec ne sera pas facturé.