API de CAPTCHA de EverySolve
API de Castle
La API de Castle de EverySolve devuelve un conjunto de tokens para tu flujo de verificación. Envía POST /api/v1/captcha con type igual a castle y las entradas indicadas a continuación.
Castle es un flujo de inteligencia de riesgo y dispositivo que recibe metadatos estructurados, no una imagen visible. Devuelve un conjunto de tokens; no debe reducirse a un solo token ni describirse como CAPTCHA visual.
- Endpoint
- POST /api/v1/captcha
- Tipo
- castle
- Por 1.000 resoluciones correctas
- $0.97 por 1.000 resoluciones correctas
Parámetros de la solicitud
Proporciona website_url, website_key y metadata. Los parámetros opcionales son count, user_agent y proxy.
Parámetros obligatorios
website_urlwebsite_keymetadataParámetros opcionales
countuser_agentproxycurl -X POST https://api.everyinfra.com/api/v1/captcha \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type":"castle","website_url":"<website_url>","website_key":"<website_key>","metadata":"<metadata>"}'
Cómo reconocer Castle
Castle es un flujo de inteligencia de riesgo y dispositivo que recibe metadatos estructurados, no una imagen visible.
Qué distingue a Castle
Devuelve un conjunto de tokens; no debe reducirse a un solo token ni describirse como CAPTCHA visual.
Origen de los parámetros de Castle
website_key y metadata deben proceder de la misma integración; count, user_agent y proxy son contexto opcional.
website_urlObligatorio- Página exacta donde aparece el reto, incluida la ruta pertinente y no solo la portada.
website_keyObligatorio- Clave pública del sitio o widget copiada de esta integración exacta; no es una clave secreta.
metadataObligatorio- Metadatos públicos y estructurados que requiere el flujo Castle.
countOpcional- Cantidad de resultados solicitada, sujeta al contrato actual del catálogo.
user_agentOpcional- Agente de usuario de la sesión; consérvalo si el resultado queda vinculado a ella.
proxyOpcional- Proxy de la sesión; reutiliza el mismo nodo de salida cuando el resultado dependa de la red.
¿Qué devuelve la API?
La API de Castle devuelve un conjunto de tokens en tokens. Su formato de solución es tokens. Usa los tokens juntos según el contrato de solicitud del flujo de destino.
- Formato de solución
- tokens
- Campos de solución
tokens
Cómo usar la API de Castle
- 01Consulta GET /api/v1/captcha/types y selecciona la entrada
castle. - 02Envía
type: "castle"y los parámetros obligatorios a POST /api/v1/captcha. - 03Consulta un conjunto de tokens en
tokens. - 04Usa los tokens juntos según el contrato de solicitud del flujo de destino.
Facturación y disponibilidad
EverySolve descuenta el importe al aceptar la solicitud y lo devuelve automáticamente si la solución no se entrega correctamente. Consulta available y los campos de precio en GET /api/v1/captcha/types cuando vayas a enviar la solicitud; no son datos estáticos de la página.
Preguntas de integración de Castle
¿Cómo identifico Castle antes de elegir el tipo?
Castle es un flujo de inteligencia de riesgo y dispositivo que recibe metadatos estructurados, no una imagen visible. Usa castle solo cuando esas señales coincidan con el reto objetivo.
¿Qué valores de la página pertenecen a una solicitud de Castle?
website_key y metadata deben proceder de la misma integración; count, user_agent y proxy son contexto opcional. Proporciona website_url, website_key y metadata. Los parámetros opcionales son count, user_agent y proxy.
¿Qué devuelve Castle y con qué no debe confundirse?
La API de Castle devuelve un conjunto de tokens en tokens. Su formato de solución es tokens. Devuelve un conjunto de tokens; no debe reducirse a un solo token ni describirse como CAPTCHA visual.
¿Qué fuente externa explica la integración de Castle?
El sitio oficial de Castle describe su contexto de riesgo y dispositivo. [Abrir la referencia de Castle](https://castle.io/). Los campos específicos de EverySolve y la disponibilidad actual siguen procediendo del catálogo de tipos.