문서
프록시 API 및 통합 문서
HTTP 또는 SOCKS5 클라이언트를 하나의 호스트와 네트워크당 하나의 로그인으로 연결하세요. 사용자 이름에 키를 입력해 위치와 세션을 선택하고, REST API로 플랜을 관리할 수 있어요.
호스트와 포트
각 네트워크는 하나의 호스트를 사용해요. HTTP와 HTTPS는 첫 번째 포트를 공유하고, SOCKS5는 두 번째 포트를 써요. 사용자 이름과 비밀번호는 대시보드의 플랜에서 확인할 수 있고, 두 프로토콜 모두 동일하게 사용해요.
| 네트워크 | 호스트 | HTTP(S) | SOCKS5 |
|---|---|---|---|
| 주거용 프록시 | res.proxyhive.cc | 7000 | 7001 |
| 모바일 프록시 | mob.proxyhive.cc | 7100 | 7101 |
| 고정 ISP 프록시 | isp.proxyhive.cc | 8000 | 8001 |
| 데이터센터 프록시 | dc.proxyhive.cc | 7200 | 7201 |
고정 ISP 플랜은 공유 호스트 대신 각 IP 주소에 고유한 포트를 제공해요. 플랜의 사용자 이름과 비밀번호로 ip:port에 연결하면 돼요.
사용자 이름 키
키는 하이픈으로 사용자 이름에 추가되며 어떤 순서로든 조합할 수 있어요. 키를 지정하지 않으면 회전형 플랜은 어떤 국가에서든 무작위 주소를 반환해요.
| 키 | 기능 | 네트워크 |
|---|---|---|
| country-us | 두 글자 ISO 국가 코드. | 주거용, 모바일, 데이터센터 |
| state-texas | 미국 주 또는 최상위 지역. | 주거용 |
| city-new_york | 도시, 소문자, 공백은 밑줄로. | 주거용, 모바일 |
| carrier-tmobile | 하나의 통신사, 소문자, 공백 없이 입력해주세요. | 모바일 |
| session-a1b2c3 | 세션당 하나의 IP를 유지하며, 6~10자의 영문 또는 숫자. | 주거용, 모바일, 데이터센터 |
| ttl-30 | 세션이 IP를 유지하는 시간(분), 1~1,440. 기본값 10. | 주거용, 모바일, 데이터센터 |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
코드 샘플
플랜의 로그인 정보로 USER와 PASS를 바꿔 주세요. 샘플 코드는 게이트웨이를 통해 하나의 요청을 보내고 응답을 출력해요.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
REST API
기본 주소 https://proxyhive.cc/api/v1. 응답은 JSON 형식이고 항상 ok를 포함해요. 공개 엔드포인트는 키가 필요 없어요. 계정 엔드포인트는 계정 페이지의 API 키와 함께 Authorization: Bearer 헤더가 필요해요.
| 메서드 | 경로 | 기능 | 키 |
|---|---|---|---|
| GET | /plans | 모든 플랜의 ID, 제품, 크기, 요금 및 가격. | 아니요 |
| GET | /locations | 풀 크기, 도시 및 통신사가 있는 국가. | 아니요 |
| GET | /balance | USD 기준 크레딧. | 예 |
| POST | /orders | 플랜 구매: 플랜 ID와 국가(또는 any). | 예 |
| GET | /orders | 로그인, 남은 트래픽 및 만료일이 포함된 플랜. | 예 |
| GET | /orders/{id} | 코드별 하나의 플랜. | 예 |
curl -X POST https://proxyhive.cc/api/v1/orders \
-H "Authorization: Bearer phk_..." \
-H "Content-Type: application/json" \
-d '{"plan": "res-100", "country": "any"}'{
"ok": true,
"order": {
"id": "HO-7K2M9QXR4T",
"product": "resi",
"plan": "res-100",
"quantity": 100,
"unit": "GB",
"status": "active",
"gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
}
}오류 및 제한
실패한 호출은 ok: false로 응답하며, 오류 코드와 메시지가 포함돼요: unauthorized (401), bad_plan 또는 bad_country (400), funds (402, 부족한 금액 표시), network (503, 요금이 청구되지 않음), rate_limited (429). 각 API 키는 분당 300회 요청을 보낼 수 있어요.