API
Enviar solicitudes a /api/v1 con el encabezado Authorization: Bearer uxp_.... Crea una clave en tu cuenta. El límite es de 60 solicitudes por minuto.
Iniciar una prueba
curl -X POST $BASE/api/v1/runs \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"site":"SITE_ID","steps":20,"concurrency":3,"personas":["p01","p03"]}'Omite personas para usar todas las habilitadas en el panel. Respuesta: {"id":"r...","status":"queued","credits":2}
Métodos
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /balance | Saldo de créditos |
| GET | /sites | Tus sitios, sus ids y paneles |
| GET | /personas | La biblioteca de personas |
| GET | /runs | Pruebas recientes |
| POST | /runs | Iniciar una prueba |
| GET | /runs/{id} | Estado y resultados por persona |
| POST | /runs/{id}/cancel | Cancelar, los créditos no usados se devuelven |
Errores
Formato: {"error":{"code":"...","message":"..."}}
| HTTP | Código | Significado |
|---|---|---|
| 400 | no_personas | No se seleccionó ninguna persona, o un id no está en este sitio |
| 400 | not_test_host | El modo de pago de prueba necesita una página de inicio en un host de prueba |
| 401 | unauthorized | Clave faltante o inválida |
| 402 | insufficient_credits | Créditos insuficientes |
| 403 | domain_not_verified | Dominio no verificado |
| 404 | not_found | Nada de eso en tu cuenta |
| 409 | too_many_runs | Demasiadas pruebas en la cola |
| 429 | rate_limited | Límite de solicitudes excedido |
Qué hace una prueba en tu sitio
Solo solicitudes GET al dominio verificado. Los formularios no se envían y los campos de contraseña y tarjeta permanecen vacíos, por lo que una prueba nunca se registra, inicia sesión o paga. La excepción es el modo de pago de prueba, que activas para un host de prueba. Las notas las escribe un modelo, revísalas antes de actuar.
