สำหรับตัวแทน

เอกสาร API ซื้อสินค้า

API รองรับ SHOPCLONE7: เว็บไซต์ SHOPCLONE6/7 ของคุณเพียงเพิ่มผู้ให้บริการประเภท SHOPCLONE7 ด้วยโดเมนนี้และ API Key ของคุณ — ไม่ต้องแก้โค้ด

รับ API Key
โดเมนhttps://beta.adswar.shop
  1. 1

    รับ API Key

    เข้าสู่ระบบ ไปที่ บัญชี › API ซื้อสินค้า เพื่อสร้างคีย์และระบุ IP เซิร์ฟเวอร์ของเว็บไซต์คุณ

  2. 2

    เชื่อมต่อเว็บไซต์

    ในหน้าผู้ดูแลเว็บไซต์ของคุณ เพิ่มผู้ให้บริการประเภท SHOPCLONE7 ด้วยโดเมนด้านบนและ API Key ที่สร้างไว้

  3. 3

    ซิงค์และขายสินค้า

    ซิงค์รายการสินค้า ตั้งราคาขาย คำสั่งซื้อของลูกค้าจะซื้ออัตโนมัติด้วยยอดเงินในกระเป๋าของคุณ

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

ทุกคำขอส่งพารามิเตอร์ api_key ใน query string ส่วนคำสั่งซื้อส่งเป็นฟอร์ม POST (multipart หรือ urlencoded)

curl -X POST "https://beta.adswar.shop/api/buy_product" \
  -F action=buyProduct -F api_key=YOUR_API_KEY -F id=12 -F amount=1
GET/api/profile.php

ข้อมูลบัญชีและยอดเงินในกระเป๋า

พารามิเตอร์

api_keyจำเป็นAPI Key ของคุณ

ตัวอย่างผลลัพธ์

{
  "status": "success",
  "msg": "Data retrieved successfully!",
  "data": { "username": "reseller01", "money": "1250.5" }
}
GET/api/products.php

หมวดหมู่และสินค้า (ราคาตามระดับของคุณ)

พารามิเตอร์

api_keyจำเป็นAPI Key ของคุณ
langไม่บังคับภาษาของชื่อสินค้า: th, en, vi

ตัวอย่างผลลัพธ์

{
  "status": "success",
  "msg": "Data retrieved successfully!",
  "categories": [
    {
      "id": "1", "parent_id": 0, "name": "Facebook", "icon": "https://.../facebook.png",
      "products": [
        { "id": "12", "name": "Facebook US | 2FA", "price": "35", "amount": 80,
          "description": "...", "flag": "us", "min": "1", "max": "500" }
      ]
    }
  ]
}
GET/api/product.php

ข้อมูลสินค้าหนึ่งรายการ

พารามิเตอร์

api_keyจำเป็นAPI Key ของคุณ
productจำเป็นID สินค้า

ตัวอย่างผลลัพธ์

{
  "status": "success",
  "msg": "Data retrieved successfully!",
  "product": [
    { "id": "12", "name": "Facebook US | 2FA", "price": "35", "amount": 80,
      "description": "...", "flag": "us", "min": 1, "max": 500 }
  ]
}
POST/api/buy_product

ซื้อสินค้า: action=buyProduct, api_key, id, amount, coupon (ไม่บังคับ)

พารามิเตอร์

actionจำเป็นใช้ buyProduct เสมอ
api_keyจำเป็นAPI Key ของคุณ
idจำเป็นID สินค้าที่ต้องการซื้อ
amountจำเป็นจำนวนที่ซื้อ (อยู่ในช่วง min – max ของสินค้า)
couponไม่บังคับโค้ดส่วนลด

ตัวอย่างผลลัพธ์

{
  "status": "success",
  "msg": "Order created successfully!",
  "trans_id": "AW261012A6YQJM7H",
  "data": ["uid|password|2fa", "uid|password|2fa"]
}
GET/api/order.php

ดึงบัญชีของคำสั่งซื้ออีกครั้ง

พารามิเตอร์

api_keyจำเป็นAPI Key ของคุณ
orderจำเป็นรหัสคำสั่งซื้อ (trans_id) ที่ได้รับตอนซื้อ

ตัวอย่างผลลัพธ์

{
  "status": "success",
  "msg": "Order retrieved successfully!",
  "trans_id": "AW261012A6YQJM7H",
  "data": ["uid|password|2fa", "uid|password|2fa"]
}

รหัสข้อผิดพลาด

เมื่อเกิดข้อผิดพลาด API จะส่ง status = "error" และข้อความ msg พร้อมรหัส HTTP:

{ "status": "error", "msg": "..." }
  • 400ขาดพารามิเตอร์ ID หรือจำนวนไม่ถูกต้อง สินค้าไม่พอ
  • 401API Key ไม่ถูกต้องหรือบัญชีถูกล็อก
  • 402ยอดเงินในกระเป๋าไม่พอ
  • 403IP ไม่อยู่ในรายการที่อนุญาต (มี client_ip แนบมา)
  • 404ไม่พบสินค้าหรือคำสั่งซื้อ
  • 429ทำรายการเร็วเกินไป กรุณารอสักครู่
  • 503API ปิดชั่วคราวหรือคลังสินค้าขัดข้อง (คืนเงินคำสั่งซื้อแล้ว)

หมายเหตุ

  • ราคาที่ส่งกลับคือราคาตามระดับของคุณ คิดเป็นสกุลเงินหลักของร้าน
  • คำสั่งซื้อชำระด้วยยอดเงินในกระเป๋า — เติมเงินก่อนที่หน้าเติมเงิน
  • การซื้อ 2 ครั้งด้วยคีย์เดียวกันต้องห่างกันไม่กี่วินาที
  • หากส่งบัญชีไม่ทัน คำสั่งซื้อยังคงส่ง trans_id กลับ — เรียก order.php เพื่อดึงภายหลัง