Crea y usa tu clave de API de solvethree

1. 1.

   Abre Claves de API

   En la consola, abre Claves de API en /api-keys dentro del espacio de trabajo previsto.

2. 2.

   Asigna un nombre a la clave

   Selecciona Crear clave de API. Introduce en Nombre de la clave un nombre que te ayude a reconocer dónde la usarás y, después, selecciona Crear clave.

3. 3.

   Copia el secreto completo

   En Guarda tu clave de API, copia el secreto y guárdalo de forma segura para tu aplicación de servidor. Solo se muestra una vez.

4. 4.

   Cierra el cuadro de diálogo

   Selecciona He guardado esta clave solo después de haber guardado el secreto.

Autentica las solicitudes con Authorization: Bearer seguido de la clave completa del espacio de trabajo. No la incluyas en el código del navegador.

Para el siguiente ejemplo, configura SOLVETHREE_API_KEY con tu secreto y SOLVETHREE_PROXY con la URL de tu proxy en el entorno del servidor. Sustituye accounts.example.com y login por el nombre de host y la acción del destino. El sitio de destino ya debe tener un perfil activo disponible para este espacio de trabajo; enviar su nombre de host no crea uno. Consulta la configuración de perfiles de sitio si aún no lo has configurado.

# Set SOLVETHREE_API_KEY and SOLVETHREE_PROXY in your environment first.
# Replace the hostname and action with your active site profile.
jq -n \
  --arg proxy "$SOLVETHREE_PROXY" \
  --arg requestId "login-$(date +%s)-$$" \
  '{site:"accounts.example.com", action:"login", proxy:$proxy, requestId:$requestId}' \
| curl --fail-with-body --max-time 30 \
  'https://api.solvethree.com/v1/tasks?waitMs=15000' \
  -H "Authorization: Bearer $SOLVETHREE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @-

Esto envía una solicitud de creación de tarea a la API pública. Crea una resolución real, no solo una comprobación de autenticación: una tarea en estado ready se factura. Una respuesta HTTP correcta por sí sola no significa que la tarea esté lista ni que el sitio web de destino vaya a aceptar su solución.

La API devuelve HTTP 401.

Comprueba la cabecera Authorization del servidor. Debe contener Bearer seguido del secreto completo, no el nombre de la clave ni un prefijo mostrado. Comprueba si la clave se ha revocado.

Prueba esto: Corrige la cabecera o sustituye la clave revocada y actualiza la configuración de tu servidor. Gestiona la respuesta HTTP no satisfactoria antes de intentar leer los datos de una tarea.

La clave permite autenticarse, pero el perfil de sitio previsto no está disponible.

Confirma a qué espacio de trabajo pertenece la clave y si ese espacio de trabajo tiene un perfil activo para el sitio de destino. Una clave válida de otro espacio de trabajo no es una credencial global.

Prueba esto: Usa una clave del espacio de trabajo que tenga el perfil previsto o configura el perfil en el espacio de trabajo que estés usando. Cambiar el nombre de host en la solicitud no lo creará.

Para otros fallos de solicitudes y tareas, consulta Errores de la API de CAPTCHA.