เอกสาร REST API
เข้าถึงบริการ 247xd ผ่าน API สำหรับระบบอัตโนมัติ
สารบัญ
1. เริ่มต้นใช้งาน
REST API ของ 247xd ให้คุณเข้าถึงบริการทั้งหมดผ่านโปรแกรม รวมถึงบริการ OTP, โซเชียลบูสเตอร์ และแอปพรีเมียม
Base URL:
https://247xd.com/api/v1วิธีเริ่มต้น:
- ลงทะเบียนและเข้าสู่ระบบที่ 247xd.com
- ไปที่หน้าโปรไฟล์ > ตั้งค่า > สร้าง API Key
- คัดลอก API Key เก็บไว้ (แสดงเพียงครั้งเดียว)
- ใช้ API Key ในส่วนหัว
Authorizationทุกครั้ง
2. การยืนยันตัวตน
ใช้ Bearer Token ในส่วนหัว Authorization สำหรับทุก request:
Authorization: Bearer 247xd_a1b2c3d4e5f6...API Key มีรูปแบบ 247xd_ ตามด้วย 40 ตัวอักษร หากคีย์ไม่ถูกต้องหรือหมดอายุ จะได้รับ HTTP 401
3. Rate Limits
จำกัดที่ 60 requests ต่อนาที ต่อผู้ใช้ ทุก response จะมีข้อมูล rate limit ในส่วนหัว:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1709312400เมื่อเกินขีดจำกัด จะได้รับ HTTP 429 พร้อมข้อความ RATE_LIMITED
4. รูปแบบ Response
ทุก response จะมีรูปแบบ JSON มาตรฐาน:
{
"success": true,
"data": { ... }
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "ไม่พบรายการ"
}
}5. ยอดเงินคงเหลือ
/api/v1/balanceดูยอดเหรียญคงเหลือในบัญชี
{
"success": true,
"data": {
"coins": 500.00
}
}6. บริการ OTP
/api/v1/otp/servicesดูรายการบริการ OTP ทั้งหมดที่เปิดให้บริการ พร้อมตัวเลือกราคาและสต๊อก
/api/v1/otp/ordersสั่งซื้อเบอร์ OTP
{
"serviceId": "uuid-of-service",
"priceOptionId": "uuid-of-price-option"
}{
"success": true,
"data": {
"orderId": "uuid",
"phoneNumber": "0812345678",
"status": "waiting_sms",
"price": 15.00,
"expiresAt": "2024-01-01T00:20:00.000Z"
}
}/api/v1/otp/orders/:orderIdตรวจสอบสถานะคำสั่งซื้อ OTP รวมถึงรหัส OTP เมื่อได้รับแล้ว
/api/v1/otp/orders/:orderId/cancelยกเลิกคำสั่งซื้อ (เฉพาะสถานะ waiting_sms)
/api/v1/otp/orders/:orderId/refundขอคืนเงินจากคำสั่งซื้อที่ยกเลิกแล้ว
7. โซเชียลบูสเตอร์
/api/v1/social/servicesดูรายการบริการโซเชียลบูสเตอร์ทั้งหมดที่เปิดให้บริการ
/api/v1/social/ordersสั่งซื้อบริการโซเชียลบูสเตอร์
{
"optionId": "uuid-of-option",
"link": "https://instagram.com/example",
"quantity": 1000
}{
"success": true,
"data": {
"orderId": "uuid",
"status": "pending",
"price": 50.00
}
}/api/v1/social/orders/:orderIdตรวจสอบสถานะคำสั่งซื้อโซเชียลบูสเตอร์
/api/v1/social/orders/:orderId/refundขอคืนเงินจากคำสั่งซื้อที่ถูกยกเลิก/ไม่สมบูรณ์
8. แอปพรีเมียม
/api/v1/premium/servicesดูรายการแอปพรีเมียมทั้งหมดที่เปิดให้บริการ พร้อมสต๊อก
/api/v1/premium/ordersสั่งซื้อแอปพรีเมียม
{
"serviceId": "uuid-of-service"
}{
"success": true,
"data": {
"orderId": "uuid",
"credentials": { ... },
"price": 99.00
}
}/api/v1/premium/orders/:orderIdดูรายละเอียดคำสั่งซื้อแอปพรีเมียม
9. รหัสข้อผิดพลาด
| HTTP | Code | คำอธิบาย |
|---|---|---|
| 400 | VALIDATION_ERROR | ข้อมูลที่ส่งมาไม่ถูกต้อง |
| 400 | BAD_REQUEST | คำขอไม่ถูกต้อง |
| 401 | UNAUTHORIZED | API Key ไม่ถูกต้องหรือไม่ได้ระบุ |
| 403 | ACCOUNT_BANNED | บัญชีถูกระงับ |
| 404 | NOT_FOUND | ไม่พบข้อมูลที่ร้องขอ |
| 429 | RATE_LIMITED | ส่งคำขอมากเกินไป |
| 500 | INTERNAL_ERROR | ข้อผิดพลาดภายในระบบ |
10. ตัวอย่างโค้ด
cURL
curl -X GET https://247xd.com/api/v1/balance \
-H "Authorization: Bearer 247xd_your_api_key_here"curl -X POST https://247xd.com/api/v1/otp/orders \
-H "Authorization: Bearer 247xd_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"serviceId": "...", "priceOptionId": "..."}'Python
import requests
API_KEY = "247xd_your_api_key_here"
BASE_URL = "https://247xd.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# ดูยอดเงิน
balance = requests.get(f"{BASE_URL}/balance", headers=HEADERS).json()
print(f"เหรียญ: {balance['data']['coins']}")
# ดูบริการ OTP
services = requests.get(f"{BASE_URL}/otp/services", headers=HEADERS).json()
# สั่งซื้อ OTP
order = requests.post(f"{BASE_URL}/otp/orders", headers=HEADERS, json={
"serviceId": "...",
"priceOptionId": "..."
}).json()
# ตรวจสอบสถานะ
order_id = order["data"]["orderId"]
status = requests.get(
f"{BASE_URL}/otp/orders/{order_id}", headers=HEADERS
).json()
print(f"สถานะ: {status['data']['status']}")JavaScript (Node.js)
const API_KEY = "247xd_your_api_key_here";
const BASE_URL = "https://247xd.com/api/v1";
const headers = {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
};
// ดูยอดเงิน
const balance = await fetch(`${BASE_URL}/balance`, { headers });
const { data } = await balance.json();
console.log(`เหรียญ: ${data.coins}`);
// สั่งซื้อ OTP
const order = await fetch(`${BASE_URL}/otp/orders`, {
method: "POST",
headers,
body: JSON.stringify({
serviceId: "...",
priceOptionId: "...",
}),
});
const result = await order.json();
console.log(`Order ID: ${result.data.orderId}`);