Docs
Proxy API at dokumentasyon ng integrasyon
I-konekta ang anumang HTTP o SOCKS5 client gamit ang isang host at isang login bawat network, pumili ng mga lokasyon at session gamit ang mga susi sa user name, at pamahalaan ang mga plan gamit ang REST API.
Mga host at port
Ang bawat network ay may isang host. Ang HTTP at HTTPS ay gumagamit ng parehong unang port, ang SOCKS5 ay gumagamit ng pangalawa. Ang user name at password ay galing sa plan sa iyong dashboard at pareho para sa parehong protocol.
| Network | Host | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Mga residential proxy | res.proxyhive.cc | 7000 | 7001 |
| Mga mobile proxy | mob.proxyhive.cc | 7100 | 7101 |
| Mga static ISP proxy | isp.proxyhive.cc | 8000 | 8001 |
| Mga datacenter proxy | dc.proxyhive.cc | 7200 | 7201 |
Ang mga static ISP plan ay naglilista ng bawat address kasama ang sarili nitong port sa halip na shared host: kumonekta sa ip:port gamit ang user name at password ng plan.
Mga susi ng user name
Ang mga susi ay idinadagdag sa iyong user name gamit ang mga hyphen at maaaring pagsamahin sa anumang pagkakasunod-sunod. Kung walang susi, ang rotating plan ay magbabalik ng random na address sa anumang bansa.
| Key | Ano ang ginagawa nito | Mga network |
|---|---|---|
| country-us | Dalawang letrang ISO country code. | Residential, mobile, datacenter |
| state-texas | Isang US state o first level region. | Residential |
| city-new_york | Isang lungsod, lowercase, mga espasyo bilang underscore. | Residential, mobile |
| carrier-tmobile | Isang mobile carrier, maliit na titik, walang espasyo. | Mobile |
| session-a1b2c3 | Pinapanatili ang isang IP para sa session, 6 hanggang 10 letra o digit. | Residential, mobile, datacenter |
| ttl-30 | Minuto na pinapanatili ng session ang IP nito, 1 hanggang 1,440. Default 10. | Residential, mobile, datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Mga halimbawa ng code
Palitan ang USER at PASS ng login ng iyong plan. Ang mga halimbawa ay nagpapadala ng isang request sa pamamagitan ng gateway at nagpi-print ng sagot.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
REST API
Base address https://proxyhive.cc/api/v1. Ang mga sagot ay JSON at laging may ok. Ang mga public endpoint ay hindi nangangailangan ng key; ang mga account endpoint ay nangangailangan ng header na Authorization: Bearer kasama ang API key mula sa iyong account page.
| Paraan | Path | Ano ang ginagawa nito | Key |
|---|---|---|---|
| GET | /plans | Bawat plan na may id, product, size, rate at presyo. | Hindi |
| GET | /locations | Mga bansa na may laki ng pool, lungsod at carrier. | Hindi |
| GET | /balance | Ang iyong credit sa USD. | Oo |
| POST | /orders | Bumili ng plan: plan id at bansa (o kahit ano). | Oo |
| GET | /orders | Ang iyong mga plan kasama ang mga login, natitirang traffic at expiry. | Oo |
| GET | /orders/{id} | Isang plan gamit ang code nito. | Oo |
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": "..." }
}
}Mga error at limitasyon
Ang mga failed call ay sumasagot ng ok: false kasama ang error code at mensahe: unauthorized (401), bad_plan o bad_country (400), funds (402, kasama ang halagang kulang pa), network (503, walang na-charge) at rate_limited (429). Ang bawat API key ay maaaring magpadala ng 300 request bawat minuto.
Magsimula sa ProxyHive
Gumawa ng account sa ilang segundo, magdagdag ng credit gamit ang crypto at kopyahin ang iyong unang proxy login. Bawat plano ay nagsisimula sa $30.