> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # hCaptcha Protokolligenkänning API Integrationsbeskrivning > hCaptcha verification code recognition service API guide - Ace Data Cloud Denna artikel kommer att introducera en hCaptcha protokolligenkänning API integrationsbeskrivning, som gör det möjligt för användare att verifiera utan att behöva identifiera och klicka på hCaptcha verifieringsbilder, utan endast genom att skicka in Website Key för att möjliggöra automatisk avkodning i bakgrunden och slutföra verifieringen. ## Ansökningsprocess För att använda hCaptcha protokolligenkänning API, börja med att gå till [Ace Data Cloud-konsolen](https://platform.acedata.cloud/console/applications) för att hämta din API-token, som du kan spara för framtida bruk. ![](https://cdn.acedata.cloud/5hmkdg.jpg) Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan som bjuder in dig att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. **En API-token räcker för att anropa alla tjänster på plattformen, det behövs ingen separat ansökan för varje tjänst.** Första ansökan ger en gratis kvot, så att du kan prova gratis; om kvoten är otillräcklig kan du ladda på allmän balans i [konsolen](https://platform.acedata.cloud/console/coin). > 📘 Fullständig dokumentation: [hCaptcha Protokolligenkänning API →](https://platform.acedata.cloud/documents/captcha-token-hcaptcha) ## Grundläggande användning Först och främst, låt oss förstå den grundläggande användningsmetoden, vilket är att ange URL:en för den webbplats som behöver hantera hCaptcha-verifieringskoden, så får vi det bearbetade resultatet. Först behöver vi enkelt skicka ett `website_url`-fält, vår exempelwebbplats är: `https://accounts.hcaptcha.com/demo`, vi behöver hämta `website_key` från `website_url`-sidan. Först öppnar vi denna webbsida, trycker på F12 för att gå till konsolen, och gör sedan en global sökning på Element-sidan efter `hcaptcha-demo`, så får vi följande resultat:

Där `data-sitekey` motsvarar en sträng som är värdet av `website_key`, här är de specifika parameterresultaten:

Vi kan se att vi har ställt in Request Headers, inklusive: * `accept`: vilken typ av svar vi vill ta emot, här anges som `application/json`, det vill säga JSON-format. * `authorization`: nyckeln för att anropa API:et, efter ansökan kan du direkt välja från rullgardinsmenyn. Dessutom har vi ställt in Request Body, inklusive: * `website_url`: URL:en för webbplatsen som behöver hantera verifieringskoden. * `website_key`: webbplatsens nyckelidentifierare i hCaptcha. När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på "Try" knappen för att göra ett test, som visas i bilden ovan, här har vi fått följande resultat: ```json theme={null} { "token": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.hadwYXNza2V5xQda4nQzFgUbYJqILiiwbvyhjocSilg8RjFHvIHmCzmqUNZa9hesIWEVRx5KIbMVeAQzSTWCwXmiQrPZuIEmZz-ZPL6DPNmB3ZXtJNsVYRLdRyvWPTB7EYskJG85yDVor2TcgQFNqAahhKT3WXjtk3S54ZBhv7QvaImUmos8MWgUOvUZHsvUtojN-izWIrBkD1if_71quOHvcvEVTLcSLx9dOgzpNAJ8_6BmJEsGlPbMGnSKrS1QfpPyzvgrnpjjIY_6TMYwJrR0EwJgCdp_lfc4mkxl0NJsZt8D_q7jcv3v6jt1CZ2qbqF5_-i4y0MYnQMCm1T62xBPdiEyst_FtGuWxJllkrrmWN0edyWcWeasLcCS6qpRry0H7RU7DYQnML6dmQoZg15NT0tFrAYeLK7EwvJxzcFbvUQ-Tc5QVk7tzvKpDtUVfQeZmRRgxWbCFf6bAT1z0uUwdma1O1lcTkSZCC5cVTaprkkKE04Ov4aCIKg2N7WGj4r0AOykisAISX5oidF3gejDTJy9vU1hgaCYFOimnwRKyqRsJdznptzhzDOQuICuAHYT3is1sY26ltJGOZTdDKkt2i2owCoAylgLbBP8VjTOGrsM12IH3Xsy076O40RCG6zThWN5TFKSpl7PNA6l2KoW-P3_K9WORjx2DSvKTAwqcouSU-0Rc_8Hlq9cIuS1iDhiNfJnJ_zNy_2gXSR2j7NP7m_lsfwELKypKm6pPzIhOuz5RwPotfPQfXOMdF3Xy98iQiihZmuHENvLAhjV_W7NL9TK3THPwDTFriS8ghIncl02v-fVARXDiuFTvjjlegL7xbHgIrOhLpunsxLiwdImUWatEI9jqaf84X4BtoS0TGYo4pHkpIG10dhoz3vooeSToAws6tz7ZWSHm6naksZ41X_WIxd7N8P9yzxrbLgVv-nHia5qHQLDmiZf3alITKhtisennw8NpespaQIVZzw_B16bdUNKqHCCTLdFbr16-3KpRoHzOOU2kBhV-gDN0NiA3ecqIMnyMdnpKlUpnjJ5sMA3e0pKEX_Vbu8DE8zfkcwLIwCIb2BLrKEHnCvv4JX8TfBktzMc5oTtZyEu-E_6ew0mSm_nhVsGtmLXSsB81FP9VGGRd50buIXRNW4GFp3XdTmYyuN32kc-AHJ5kKDj2HGraHxKco0McT7nV2bgx97k-C7hgxL2x5t3lC97edphh2kt2-gXuTxxfB7K-ZG6w5d1MnRte4ZG7TxvPFFi5693IFRFbvcr-U3WyGZJmGGdfV55PnoIU9Qn-WDtBU4EXyvd_KTt-asHtI6VQiVSNzacemTfsu9WBF33f2gafDY4qqhyXDPNsu6BZCGMSBhxDPURY74OBr4mYOdhjELY07nSkr9RQtQwiiSa8B8XFlezCPafjgdbmmNzG3PXa3n23sSwVnJHpHhq79eTP_KeeCiqlCvNsHLEfiH5HCNRGp7v5b342wBk__BWFimJMvohz0rucTVYgVFBdTOomUTuqCPeUgDP3X6BnNqyVDRA-HrdRl-RkU6mnw-3-IwyMZQ-fEnFMzbGp3zaoY7Do2jKvKKILoq6Q8zlDYkrLwuXjDP-nernI2hxP9wVOUVmtq5Rs19RLUI4MNWZAqwG-wGnaoB756d8nfmh5XhFzvArE5bpL50FY1yJqv7nbPW7JNnkfZG80yVRrIZO_F9NEb3n4eiIzg9Gu9fv8ncyChiCCp-swK5B7_w-XsAlco98bO-YK-fFMJOhyt0PU8Zc-hYoCa6cLVTvhdPzIUA0CQOemg4Pz6PX6SVwLYSlOXYkzbrgBlyH5YBS3oaRCeavVLrJsKt0_KwHwgBa1mdP5mlYUpBDbKR4PKwknU7y111JH0B4fO39dOVA-zecvDG0bnuy98Jym4KUchZr1tXabMcM20mg1UvcxMfnKOx0ojBcVwYA7kPQK3EzMnwX9NbAzYP6IlMgjFK9ZM7HCXxN6J1_6kw10RT4O58-Pbh3cMSrZDfM-GuG7p7XrVpJrX8TD195DCJqx-DmVv3Bs3CiuCPTvGrSZ58KE4hQagidGreUD2WXxLBFfTv1RgM3eXMtROs7hddyBajIu401lxucNbpRB7lYV7pJwxG7LQoSZ2G2LzG8eFPVPIkDNVOa8nGzh-sWaF7kc7bVv-P4FXbLX0WCjvQRES2MCbXPyJ-OpZZXZcJy7SOsGY3jZbTkGoez19cRQLiFO35gA5l9FBptDKW-_yGemt5XeKsR_FwGPN9C-0k1E-28oB4iKo-h1zb2kJpilhnmG36Z59F5T6W77M7OD_N6VHRWuPClLElO09OrPLHbJmxq9JvMWjTg5JjEaqyTLyLXWgw0N3kZMCqJJeqNj5w5I7dpuJ6ScfXKVaT96v2UESebdbMFT7vkZAkFF8LIowkN56pNwXLHkB2KyIWR2WQL-335BEpQ0AVB6RX4kdociIhtvAdsIE6pvFIwkzyO0OvIHxzOwPxZKdmDmBVMu7YxJStrhY-XWCu4kO5gDIJ0iedPWKNleHDOZuZqGKhzaGFyZF9pZM4xrUyBomtyqDE1ZmUwNDhkonBkAA.dVWyVc6N3lx2ZJQ7NJ9aEsWA-KAIuQ4PMSKVGQuWyCA" } ``` Vi kan se att vi har fått verifieringsresultatet för att hantera hCaptcha-verifieringskoden, och sedan kan vi använda det för att POST:a eller simulera en inlämning till målsidan, engångsanvändning, giltighetstid 120 sekunder, rekommenderas att använda inom 60 sekunder. Nästa steg kommer att ge en CURL-version som skickar den bearbetade token till målsidan för att passera Recaptcha2-verifieringen. Först behöver vi ta reda på hur webbplatsen skickar POST-förfrågningar, så att vi kan skicka den genererade token. Vi behöver först öppna F12-konsolen och sedan manuellt genomföra verifieringen. Slutligen kan vi se att webbplatsen skickade en POST-förfrågan, och vi behöver bara titta på konstruktionen av denna POST-förfrågan. Den specifika processen är som följer: * Först genomför vi verifieringen manuellt, som visas i bilden nedan:

* Klicka sedan på submit och observera förändringarna i nätverkskonsolen, som visas i bilden nedan:

* Analysera konstruktionen av den här POST-förfrågan, och slutligen kan vi högerklicka på förfrågan för att kopiera CURL-koden, som visas i bilden nedan:

Från bilden ovan kan vi se att URL:en för denna POST-förfrågan är: `https://accounts.hcaptcha.com/demo`, vi behöver bara skicka parametrarna `g-recaptcha-response`, `h-captcha-response` och `email`, och sedan behöver vi bara skicka den bearbetade token i nedanstående data. CURL-koden för att anropa tokenverifieringen är som följer: ```shell theme={null} curl 'https://accounts.hcaptcha.com/demo' \ --data-raw 'email=&g-recaptcha-response={token}&h-captcha-response={token}' ``` Python-koden för att anropa tokenverifieringen är som följer: ```python theme={null} import requests token = '{token}' data = { 'email': '', 'g-recaptcha-response': token, 'h-captcha-response': token } response = requests.post('https://accounts.hcaptcha.com/demo', data=data) if response.status_code == 200: print(response.text) ``` Sedan observerar vi att konsolen visar ett sådant resultat:

Slutligen har vi passerat hCaptcha-verifieringen. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genereras, till exempel CURL-koden är som följer: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/captcha/token/hcaptcha' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2", "website_url": "https://accounts.hcaptcha.com/demo" }' ``` Python-integrationskoden är som följer: ```python theme={null} import requests url = "https://api.acedata.cloud/captcha/token/hcaptcha" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2", "website_url": "https://accounts.hcaptcha.com/demo" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ## Asynkron läge (async) Som standard är API:et synkront och blockerande: en begäran kommer att vänta tills tokenbehandlingen är klar innan den returneras. Om du gör en rotation av flera kodlösare (multi-solver rotation) och vill "få task\_id omedelbart efter att ha skickat uppgiften, först schemalägga andra kodlösare och sedan återkomma för att hämta resultatet", kan du skicka `async: true` i begärningskroppen. När du skickar `async: true` kommer gränssnittet omedelbart att returnera ett `task_id` utan att blockera väntan: ```json theme={null} { "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab", "status": "processing" } ``` Använd sedan detta `task_id` för att pollera `POST /captcha/tasks` (rekommenderas var 3-5 sekund) för att hämta resultatet: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/captcha/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002" }' ``` Under bearbetning kommer det att returnera `status: processing`: ```json theme={null} { "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "status": "processing" } ``` När bearbetningen är klar kommer det att returnera `status: ready` och token: ```json theme={null} { "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "status": "ready", "token": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1Ni......" } ``` Avgiftsbeskrivning: I asynkront läge debiteras varken skapande av uppgifter eller polling "under bearbetning"; **endast när token framgångsrikt hämtas debiteras en gång** (till samma pris som i synkront läge). Därför kommer avbokning av ännu inte slutförda uppgifter under rotationen inte att medföra kostnader. `/captcha/tasks` är gemensam för alla verifieringsgränssnitt (token och recognition-serier, såsom hcaptcha, recaptcha2, recaptcha3, recognition/\* etc.) och kan pollas med samma `task_id`. ## Felhantering När du anropar API:et, om du stöter på fel, kommer API:et att returnera motsvarande felkod och meddelande. Till exempel: * `400 token_mismatched`: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar. * `400 api_not_implemented`: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar. * `401 invalid_token`: Unauthorized, ogiltig eller saknad auktoriseringstoken. * `429 too_many_requests`: För många förfrågningar, du har överskridit hastighetsgränsen. * `500 api_error`: Intern serverfel, något gick fel på servern. ### Exempel på felrespons ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Slutsats Genom detta dokument har du lärt dig hur man använder hCaptcha-protokollet för att identifiera API så att användare inte behöver identifiera och klicka på hCaptcha-verifieringskodens bilder, utan bara behöver skicka Website Key för att möjliggöra automatisk avkodning i bakgrunden och slutföra verifieringen. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.