เอกสาร
เอกสาร API และการเชื่อมต่อ Proxy
เชื่อมต่อไคลเอนต์ 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 |
แผน Static ISP จะแสดงที่อยู่ IP แต่ละตัวพร้อมพอร์ตของตัวเองแทนที่จะใช้โฮสต์ร่วมกัน: เชื่อมต่อที่ ip:port ด้วยชื่อผู้ใช้และรหัสผ่านของแผน
คีย์ในชื่อผู้ใช้
คีย์จะถูกต่อท้ายชื่อผู้ใช้ของคุณด้วยเครื่องหมายยัติภังค์และสามารถรวมกันในลำดับใดก็ได้ หากไม่มีคีย์ แผนแบบหมุนเวียนจะส่งคืนที่อยู่ IP สุ่มในประเทศใดก็ได้
| คีย์ | หน้าที่ | เครือข่าย |
|---|---|---|
| country-us | รหัสประเทศสองตัวอักษรตามมาตรฐาน ISO | Residential, โมบาย, datacenter |
| state-texas | รัฐในสหรัฐอเมริกาหรือภูมิภาคระดับแรก | Residential |
| city-new_york | ชื่อเมือง ตัวพิมพ์เล็ก ช่องว่างแทนด้วยขีดล่าง | Residential, โมบาย |
| carrier-tmobile | ผู้ให้บริการเครือข่ายมือถือหนึ่งราย ตัวพิมพ์เล็ก ไม่มีช่องว่าง | โมบาย |
| session-a1b2c3 | รักษาที่อยู่ IP เดียวสำหรับเซสชัน 6 ถึง 10 ตัวอักษรหรือตัวเลข | Residential, โมบาย, datacenter |
| ttl-30 | จำนวนนาทีที่เซสชันจะคงที่อยู่ IP เดียว 1 ถึง 1,440 ค่าเริ่มต้น 10 | Residential, โมบาย, datacenter |
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 เสมอ ปลายทางสาธารณะไม่ต้องใช้คีย์ ปลายทางบัญชีต้องมีส่วนหัว Authorization: Bearer พร้อมคีย์ API จากหน้าบัญชีของคุณ
| เมธอด | พาธ | หน้าที่ | คีย์ |
|---|---|---|---|
| GET | /plans | ทุกแผนพร้อมรหัส, ผลิตภัณฑ์, ขนาด, อัตราและราคา | ไม่ |
| GET | /locations | ประเทศที่มีขนาดพูล, เมืองและผู้ให้บริการเครือข่าย | ไม่ |
| GET | /balance | เครดิตของคุณใน USD | ใช่ |
| POST | /orders | ซื้อแผน: รหัสแผนและประเทศ (หรือใดๆ) | ใช่ |
| 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 ครั้งต่อนาที
เริ่มต้นใช้งาน ProxyHive
สร้างบัญชีในไม่กี่วินาที เติมเครดิตด้วยคริปโตและคัดลอกการล็อกอินพร็อกซีแรกของคุณ ทุกแผนเริ่มต้นที่ $30