# เอกสาร API ของ LocalSERP Proxy

> REST API ของ LocalSERP Proxy ที่ localserpproxy.com/api: API keys, ข้อผิดพลาด, ขีดจำกัด และ endpoints สำหรับยอดเงิน การเติมเงิน คำสั่งซื้อ และพร็อกซี

- URL: https://localserpproxy.com/th/docs/api/
- อัปเดตล่าสุด: 2026-10-15
- Publisher: LocalSERP Proxy (https://localserpproxy.com)

คุณสามารถเขียนสคริปต์ให้ทำทุกอย่างในบัญชีได้: ตรวจสอบยอดเงิน เติมเงินด้วยคริปโต ซื้อแพ็กเกจ สร้างข้อมูลเข้าสู่ระบบพร็อกซี และเปลี่ยน IP มือถือ รับส่ง JSON ผ่าน HTTPS ด้วย API key เพียง 1 รายการ พร้อมตัวอย่างสำหรับ curl, Python และ Node.js

## ใช้ API ของ LocalSERP Proxy อย่างไร?

**คำตอบสั้น ๆ**

ส่งคำขอ HTTPS ไปที่ `https://localserpproxy.com/api/v1` โดยใส่ API key ใน header `Authorization: Bearer API_KEY` สร้าง key ได้ที่ [หน้าสำหรับนักพัฒนา](https://localserpproxy.com/app/developer?lang=th) ในบัญชีของคุณ (หรือใช้ `POST /v1/api-keys`) และกำหนดเฉพาะ scopes ที่จำเป็น คำขอและคำตอบเป็น JSON ส่วนข้อผิดพลาดจะแสดงเป็น `{ "error": { "code", "message" } }` เสมอ

## ข้อมูลโดยสรุป

| คุณสมบัติ | ค่า |
| --- | --- |
| Base URL | `https://localserpproxy.com/api/v1` |
| รูปแบบ | JSON ผ่าน HTTPS, UTF-8 |
| การยืนยันตัวตน | API key: `Authorization: Bearer API_KEY` |
| ขอบเขตสิทธิ์ของ API key | `read`, `proxies`, `billing` |
| สกุลเงิน | USD ในรูปแบบสตริงที่มีทศนิยม 2 ตำแหน่ง (`"29.00"`) |
| จำนวนเงินคริปโต | สตริงทศนิยม ห้ามใช้ตัวเลขแบบ floating-point (`"0.00045210"`) |
| ปริมาณการใช้งาน | ไบต์ (1 GB = 1,000,000,000 ไบต์) |
| วันที่ | ISO 8601 ใน UTC (`2026-10-05T14:03:11Z`) |
| เวอร์ชัน | `/v1` ในทุก path |

## การยืนยันตัวตน

ทุกคำขอ ยกเว้นแค็ตตาล็อกสาธารณะ ต้องมี API key: `Authorization: Bearer API_KEY` ระบบจะแสดง key แบบเต็ม **เพียงครั้งเดียว** ตอนสร้าง ให้เก็บรักษาเหมือนรหัสผ่าน คุณเพิกถอน key ได้ทุกเมื่อ หลังจากนั้นคำขอที่ใช้ key ดังกล่าวจะได้รับ `401 unauthorized`

### ขอบเขตสิทธิ์

กำหนดสิทธิ์ให้แต่ละ key เท่าที่สคริปต์ของคุณต้องใช้เท่านั้น หาก key ไม่มีขอบเขตสิทธิ์ที่จำเป็น ระบบจะส่ง `403 forbidden`

| ขอบเขตสิทธิ์ | สิ่งที่อนุญาต |
| --- | --- |
| `read` | อ่านข้อมูลทั้งหมด (บัญชี ยอดคงเหลือ บริการ การใช้งาน) |
| `proxies` | เปลี่ยนการตั้งค่าและข้อมูลเข้าสู่ระบบพร็อกซี (ป้ายกำกับ การต่ออายุอัตโนมัติ รหัสผ่านใหม่) จัดการผู้ใช้ย่อย จัดการรายการ IP ที่อนุญาต และหมุนพอร์ตมือถือ (รวมลิงก์สำหรับหมุนพอร์ต) |
| `billing` | สร้างคำสั่งซื้อและเติมเงิน โดยชำระจากยอดเงินคงเหลือ |

ข้อยกเว้นเพียงอย่างเดียวคือ **ลิงก์สำหรับหมุนพอร์ตมือถือ** ซึ่งออกแบบมาให้เรียกใช้จากบุ๊กมาร์กในเบราว์เซอร์หรือ `curl` แบบธรรมดา: `GET https://localserpproxy.com/api/v1/mobile/PORT_ID/rotate?key=API_KEY` (คีย์ที่มีขอบเขต `proxies`) ดู [พอร์ตมือถือและการหมุน IP](https://localserpproxy.com/th/docs/api/mobile/).

*ตรวจสอบยอดเงินคงเหลือของคุณ*

```bash
curl -s "https://localserpproxy.com/api/v1/balance" \
  -H "Authorization: Bearer $API_KEY"
```

## คำขอและการตอบกลับ

- **รับ JSON และส่ง JSON กลับ**: ส่ง `Content-Type: application/json` พร้อมเนื้อหาคำขอ
- **รายการ** ที่อาจมีจำนวนเพิ่มขึ้นจะแบ่งหน้าโดยใช้ `page` (เริ่มจาก 1) และ `perPage` (1–100 ค่าเริ่มต้น 20) และส่งกลับเป็น `{ "data": [...], "pagination": { "page", "perPage", "total", "totalPages" } }` รายการสั้น ๆ จะส่งกลับเป็น `{ "data": [...] }`
- **ID** เป็นสตริงที่ไม่เปิดเผยความหมาย พร้อมคำนำหน้าระบุประเภท: `ord_` (คำสั่งซื้อ), `top_` (การเติมเงิน), `txn_` (รายการเคลื่อนไหวยอดเงิน), `res_` (การสมัครแพ็กเกจทราฟฟิก), `mob_` (พอร์ตมือถือ), `key_` (คีย์ API) และ `ipw_` (รายการ IP ที่อนุญาต)
- **ลองส่งซ้ำได้อย่างปลอดภัย**: `POST /v1/orders` และ `POST /v1/topups` รองรับส่วนหัว `Idempotency-Key` (สตริงใดก็ได้ที่ไม่ซ้ำกัน โดยเก็บไว้ 24 ชม.) เมื่อส่งคีย์เดิมซ้ำ ระบบจะส่งการตอบกลับครั้งแรก แทนการซื้อหรือเติมเงินซ้ำ
- **ตัวอย่าง** แสดงรูปแบบของคำตอบแต่ละรายการ: ID, IP, จำนวนเงิน และวันที่เป็นข้อมูลประกอบ ส่วน ID แพ็กเกจและราคาเป็นข้อมูลจริง

## ข้อผิดพลาด

ข้อผิดพลาดทุกรายการมีเนื้อหาในรูปแบบเดียวกัน `code` มีค่าคงที่และออกแบบมาให้โค้ดของคุณนำไปใช้ ส่วน `message` เป็นประโยคภาษาอังกฤษที่อาจเปลี่ยนแปลงได้ ข้อผิดพลาดในการตรวจสอบความถูกต้องจะแสดงฟิลด์ที่ไม่ถูกต้องแต่ละรายการใน `fields` อาจมีการเพิ่มรหัสใหม่ โปรดจัดการรหัสที่ไม่รู้จักให้เป็นข้อผิดพลาดทั่วไป

*422 validation_failed*

```json
{
  "error": {
    "code": "validation_failed",
    "message": "Some fields are invalid.",
    "fields": [
      {
        "field": "amountUsd",
        "code": "too_small",
        "message": "The minimum top-up is 25.00 USD."
      }
    ],
    "requestId": "req_2b7c0f"
  }
}
```

### รหัสสถานะ

| สถานะ | ความหมาย |
| --- | --- |
| `422` | `validation_failed`: มีฟิลด์อย่างน้อย 1 รายการไม่ถูกต้อง |
| `401` | `unauthorized`: ไม่มีโทเค็น โทเค็นไม่ถูกต้อง หรือหมดอายุแล้ว |
| `402` | `insufficient_balance`: ยอดเงินไม่เพียงพอสำหรับคำสั่งซื้อ `details` = `InsufficientBalanceDetails` |
| `403` | `forbidden`: API key ไม่มีสิทธิ์เข้าถึงที่จำเป็น หรือบัญชีถูกระงับ |
| `404` | `not_found`: ไม่มีทรัพยากรนี้ หรือเป็นของบัญชีอื่น |
| `409` | `conflict` (หรือรหัสที่เฉพาะเจาะจงกว่า): ไม่สามารถดำเนินการนี้ได้ในสถานะปัจจุบัน |
| `429` | `rate_limited` หรือ `rotation_too_soon` |

## ขีดจำกัดอัตราการเรียกใช้

ทุกการตอบกลับจะมี `RateLimit-Limit`, `RateLimit-Remaining` และ `RateLimit-Reset` หากเรียกใช้เกินขีดจำกัด API จะตอบกลับด้วย `429 rate_limited` พร้อมส่วนหัว `Retry-After` (หน่วยเป็นวินาที): รอตามเวลาที่ระบุแล้วลองอีกครั้ง เปลี่ยน IP ของพอร์ตมือถือได้ไม่เกินทุก 30 วินาที (`429 rotation_too_soon` พร้อม `Retry-After`)

## เอกสารอ้างอิง API

- **[บัญชีและยอดเงิน](https://localserpproxy.com/th/docs/api/account/)** — ดูการตั้งค่าบัญชี ยอดเงินคงเหลือแบบเติมเงิน USD และรายการเคลื่อนไหวของยอดเงินทั้งหมด (การเติมเงิน การซื้อ และการคืนเงิน)
- **[เติมเงินด้วยคริปโต](https://localserpproxy.com/th/docs/api/top-ups/)** — เติมเงินด้วยคริปโต: รับที่อยู่สำหรับฝากและจำนวนเงินที่แน่นอน ส่งเงินตามจำนวนดังกล่าว แล้วแจ้งว่าชำระเงินแล้ว (ไม่จำเป็นต้องระบุ ID ธุรกรรม) จากนั้นติดตามรายการเติมเงินจนกว่ายอดเงินจะเข้าบัญชี ยอดเงินนี้ใช้ชำระแพ็กเกจใดก็ได้ของเรา
- **[คำสั่งซื้อ](https://localserpproxy.com/th/docs/api/orders/)** — ดูรายการแพ็กเกจและราคา ซื้อแพ็กเกจด้วยยอดเงินคงเหลือ (บริการใหม่ เพิ่มปริมาณทราฟฟิก หรือต่ออายุพอร์ต) และดูคำสั่งซื้อที่ผ่านมา
- **[พร็อกซีเรซิเดนเชียลและข้อมูลเข้าสู่ระบบ](https://localserpproxy.com/th/docs/api/residential/)** — จัดการการสมัครใช้บริการทราฟฟิก (พร็อกซีเรซิเดนเชียลและพร็อกซีมือถือแบบหมุนเวียน 4G/5G คิดค่าบริการต่อ GB): ข้อมูลเข้าสู่ระบบพร็อกซี ผู้ใช้ย่อยที่มีข้อมูลเข้าสู่ระบบและขีดจำกัดทราฟฟิกของตนเอง การใช้งานรายวัน และตำแหน่งที่กำหนดเป้าหมายได้ในชื่อผู้ใช้พร็อกซี
- **[พอร์ตมือถือและการหมุนเวียน IP](https://localserpproxy.com/th/docs/api/mobile/)** — พอร์ต 4G/5G แบบเฉพาะ: เปลี่ยน IP ได้ทันทีหรือตั้งเวลา ใช้ลิงก์หมุนเวียน IP และตรวจสอบปริมาณการใช้งานรายวัน
- **[คีย์ API และรายการ IP ที่อนุญาต](https://localserpproxy.com/th/docs/api/api-keys/)** — สร้างและเพิกถอนคีย์ API พร้อมกำหนดสิทธิ์การใช้งาน และจัดการรายการ IP ที่อนุญาต: อนุญาตให้ IP ต้นทางได้สูงสุด 10 รายการใช้พร็อกซีโดยไม่ต้องใช้ชื่อผู้ใช้และรหัสผ่าน

> **ชำระเงินจากสคริปต์** ชำระแพ็กเกจจากยอดเงิน USD แบบเติมเงินล่วงหน้าเท่านั้น เติมเงินด้วยคริปโต (ขั้นต่ำ 25.00 USD) ผ่าน POST /v1/topups จากนั้นซื้อผ่าน POST /v1/orders ทำทั้งสองรายการได้ในคำขอเดียว: การเติมเงินอาจแนบคำสั่งซื้อไว้ใน purchase และระบบจะซื้อแพ็กเกจทันทีเมื่อเติมเงินเข้ายอดแล้ว

---

LocalSERP Proxy: LocalSERP Proxy เป็นบริการพร็อกซีเรซิเดนเชียลในสหรัฐฯ สำหรับตรวจสอบผลการค้นหาในพื้นที่ โฆษณา และราคาเป็นรายเมือง ชำระเงินด้วยคริปโตโดยไม่ต้องอัปโหลดเอกสารยืนยันตัวตน.