API
요청 보내기 /api/v1 헤더와 함께 Authorization: Bearer uxp_.... 계정에서 키를 생성하세요. 분당 60회 요청이 제한됩니다.
런 시작
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"]}'personas를 생략하면 패널에서 활성화된 모든 페르소나가 사용됩니다. 응답: {"id":"r...","status":"queued","credits":2}
메서드
| 메서드 | 경로 | 기능 |
|---|---|---|
| GET | /balance | 크레딧 잔액 |
| GET | /sites | 귀하의 사이트, ID 및 패널 |
| GET | /personas | 페르소나 라이브러리 |
| GET | /runs | 최신 런 |
| POST | /runs | 런 시작 |
| GET | /runs/{id} | 페르소나별 상태 및 결과 |
| POST | /runs/{id}/cancel | 취소: 완료되지 않은 크레딧은 반환됩니다 |
오류
형식: {"error":{"code":"...","message":"..."}}
| HTTP | 코드 | 의미 |
|---|---|---|
| 400 | no_personas | 페르소나가 선택되지 않았거나 해당 ID가 이 사이트에 없습니다 |
| 400 | not_test_host | 테스트 결제 모드는 테스트 호스트의 시작 페이지가 필요합니다 |
| 401 | unauthorized | 키가 없거나 유효하지 않습니다 |
| 402 | insufficient_credits | 크레딧이 부족합니다 |
| 403 | domain_not_verified | 도메인이 검증되지 않았습니다 |
| 404 | not_found | 계정에 해당 항목이 없습니다 |
| 409 | too_many_runs | 대기열에 너무 많은 테스트가 있습니다 |
| 429 | rate_limited | 요청 한도를 초과했습니다 |
사이트에서 테스트가 수행되는 방식
검증된 도메인으로의 GET 요청만 수행됩니다. 양식은 제출되지 않으며 비밀번호 및 카드 필드는 비워두어 테스트 실행이 회원가입, 로그인 또는 결제를 수행하지 않습니다. 단, 테스트 호스트에 대해 활성화한 테스트 결제 모드는 예외입니다. 메모는 AI 모델이 작성하므로 수정 전에 확인하세요.
