API 레퍼런스

Base URL: https://browserip.com. 인증: 먼저 POST /api/auth/login 으로 로그인하면 서버에서 sid cookie를 발급하고, 이후 요청에는 cookie를 함께 보내면 됩니다. 콘솔 「API Keys」 페이지에서 생성한 Key도 사용할 수 있습니다. 요청 헤더 Authorization: Bearer bip_… 를 사용하면 cookie가 필요 없습니다(Key는 한 번만 표시되므로 안전하게 보관하세요).

전원 켜기 POST /api/sessions/

curl -b cookies.txt -X POST https://browserip.com/api/sessions/ \
  -H 'Content-Type: application/json' -d '{}'

성공(유휴 슬롯이 있는 경우) → 200:

{
  "session": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "ready",
    "region": "default",
    "token": "…",
    "cdp_url": "https://browserip.com/s/123e4567-e89b-12d3-a456-426614174000/…",
    "view_url": "/view/123e4567-e89b-12d3-a456-426614174000/…",
    "created_at": "2026-10-19T00:00:00.000Z",
    "last_activity": "2026-10-19T00:00:00.000Z"
  }
}

유휴 슬롯이 없고 확장이 이미 시작된 경우 → 202 {"session": {...}, "queue_position": 1}(GET /api/sessions/:id 를 폴링하며 status가 ready가 될 때까지 기다립니다). 오류: 402 insufficient_credits(잔액 부족), 429 too_many_sessions, 503 no_capacity.

세션 조회 GET /api/sessions/:id

{"session": {"id": "123e4567-e89b-12d3-a456-426614174000", "status": "ready", "cdp_url": "https://browserip.com/s/123e4567-e89b-12d3-a456-426614174000/…", …}}

종료 DELETE /api/sessions/:id

curl -b cookies.txt -X DELETE https://browserip.com/api/sessions/123e4567-e89b-12d3-a456-426614174000
→ {"ok": true}

사용자 정보 조회 GET /api/auth/me

{"user": {"id": "u_x", "email": "[email protected]", "hours": 4.5, "credits": 0, "account_type": "personal", "credit_rate_per_hour": null, "is_admin": false, "created_at": "…"}} 

잔액 조회 GET /api/billing/balance

현재 잔액을 반환합니다. 개인 사용자는 hours(시간), 기업/관리자는 credits이며, account_type와 기업 요율 credit_rate_per_hour도 함께 반환됩니다.