REST API v2

ภาพรวม

นี่คือพื้นผิวที่เอเจนต์ AI ขับเคลื่อน ทุกการเรียกคือหนึ่งคำสั่งที่เลือกด้วย action ดังนั้นเอเจนต์จึงค้นหาแคตตาล็อก อ่านอัตราและขีดจำกัดกลับมา แล้วลงมือ ค้นหาแล้วลงมือ โดยยืนยันราคาก่อนที่เงินจะเคลื่อนไหว เซิร์ฟเวอร์ MCP และ CLI ห่อหุ้มการเรียกเหล่านี้ไว้ หน้านี้คือโปรโตคอลดิบที่อยู่เบื้องล่าง

API ปฏิบัติตามรูปแบบ SMM API v2 ที่ถูกนำไปใช้อย่างแพร่หลาย ดังนั้นซอฟต์แวร์แผงควบคุม สคริปต์ และการเชื่อมต่อเอเจนต์ที่มีอยู่จึงทำงานได้โดยแก้ไขเพียงเล็กน้อย ทุกการดำเนินการผ่าน เอนด์พอยต์เดียว และเลือกคำสั่งด้วยพารามิเตอร์ action การตอบกลับเป็น JSON ง่ายสำหรับสคริปต์หรือ LLM ที่จะแยกวิเคราะห์และเชื่อมโยง

เอนด์พอยต์

POST https://api.socialgo.com/api/v2

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

การยืนยันตัวตนเป็นแบบต่อคำขอ ไม่มีเซสชัน ไม่มีการจับมือ ซึ่งเป็นสิ่งที่ทำให้เอเจนต์เรียกใช้ได้ ส่ง key ลับของคุณในทุกการเรียก ค้นหาและหมุนเวียนได้ในแดชบอร์ดภายใต้ Account → API ปฏิบัติต่อคีย์เหมือนรหัสผ่าน: เก็บไว้ฝั่งเซิร์ฟเวอร์ ไม่เคยอยู่ในโค้ดฝั่งไคลเอนต์หรือพรอมต์ของเอเจนต์

รูปแบบคำขอ

ส่งพารามิเตอร์ฟอร์ม application/x-www-form-urlencoded ผ่าน POST ทุกการตอบกลับเป็น JSON มีสองพารามิเตอร์ในทุกการเรียก:

• key: คีย์ API ของคุณ (จำเป็น)
• action: คำสั่งที่จะเรียกใช้ (จำเป็น)

รูปแบบข้อผิดพลาด

เมื่อล้มเหลว การตอบกลับจะมีฟิลด์ error พร้อมข้อความที่มนุษย์อ่านได้ และสถานะ HTTP สะท้อนถึงปัญหา (เช่น 400 คำขอไม่ถูกต้อง, 401 คีย์ไม่ถูกต้อง) รูปแบบเดียวที่คาดเดาได้ ดังนั้นสคริปต์หรือเอเจนต์จึงสามารถแตกแขนงตามนั้นได้โดยไม่ต้องเดา

{
  "error": "Incorrect request"
}

การดำเนินการ (Actions)

แต่ละคำสั่งทำหน้าที่เดียว เอเจนต์เชื่อมโยงตามลำดับ: services เพื่อค้นหาว่าจะซื้ออะไร, add เพื่อซื้อ, status เพื่อติดตาม การเรียกแบบอ่าน (services, status, balance) ช่วยให้ยืนยันราคาและเงินทุนก่อนที่การเรียกแบบเขียน (add, refill, cancel) จะใช้จ่ายใดๆ

1. แสดงรายการบริการ

แคตตาล็อกที่เอเจนต์อ่านก่อน: ทุกบริการที่สามารถสั่งได้ พร้อมรหัสบริการ หมวดหมู่ อัตรา (ราคาต่อ 1000) และจำนวนต่ำสุด/สูงสุด เอเจนต์ใช้รหัส service ที่ส่งกลับมาเพื่อสั่งซื้อ และใช้อัตราเพื่อยืนยันต้นทุนก่อนใช้จ่าย

คำขอ

key=YOUR_API_KEY
action=services

การตอบกลับ

[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  },
  {
    "service": 2,
    "name": "Instagram Likes",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.40",
    "min": "10",
    "max": "20000",
    "refill": false,
    "cancel": true
  }
]

2. เพิ่มคำสั่งซื้อ

การเรียกแบบเขียน สั่งซื้อสำหรับหนึ่งบริการ ส่งรหัส service, link เป้าหมาย และ quantity การตอบกลับจะส่งคืนรหัส order ใหม่เพื่อติดตาม เอเจนต์จะเรียกใช้สิ่งนี้หลังจากยืนยันอัตราและขีดจำกัดแล้วเท่านั้น

พารามิเตอร์

• service: รหัสบริการจากรายการบริการ
• link: URL ของโพสต์ / โปรไฟล์ / ช่อง
• quantity: จำนวนหน่วยที่จะจัดส่ง

คำขอ

key=YOUR_API_KEY
action=add
service=1
link=https://instagram.com/example
quantity=1000

การตอบกลับ

{
  "order": 23501
}

3. เพิ่มคำสั่งซื้อ, ทยอยส่ง

แบ่งหนึ่งคำสั่งซื้อออกเป็นการจัดส่งย่อยๆ กระจายตามเวลา เพื่อกราฟที่สม่ำเสมอขึ้น ตั้งค่า runs (จำนวนการจัดส่ง) และ interval (นาทีระหว่างแต่ละครั้ง) ยอดรวมที่จัดส่งคือ quantity × runs การคำนวณที่เอเจนต์ใช้เพื่อกำหนดขนาดแคมเปญโดยที่คุณไม่ต้องทำเอง

พารามิเตอร์เพิ่มเติม

• runs: จำนวนรอบการจัดส่ง
• interval: นาทีระหว่างแต่ละรอบ

คำขอ

key=YOUR_API_KEY
action=add
service=1
link=https://instagram.com/example
quantity=1000
runs=10
interval=60

การตอบกลับ

{
  "order": 23502
}

4. สถานะคำสั่งซื้อ

ส่งคืนสถานะปัจจุบันของหนึ่งคำสั่งซื้อ: ค่าใช้จ่าย ยอดเริ่มต้น สถานะ จำนวนที่เหลือ และสกุลเงิน นี่คือวิธีที่เอเจนต์เฝ้าดูคำสั่งซื้อโดยที่คุณไม่ต้องรีเฟรชแดชบอร์ด และวิธีที่มันตรวจพบยอดตกที่ควรทำเครื่องหมายเพื่อเติมคืน

คำขอ

key=YOUR_API_KEY
action=status
order=23501

การตอบกลับ

{
  "charge": "0.90",
  "start_count": "4250",
  "status": "In progress",
  "remains": "200",
  "currency": "USD"
}

ค่า status ที่เป็นไปได้: Pending, In progress, Processing, Completed, Partial, Canceled.

5. สถานะคำสั่งซื้อหลายรายการ

ตรวจสอบคำสั่งซื้อหลายรายการในการเรียกเดียว ส่งรายการรหัสที่คั่นด้วยเครื่องหมายจุลภาคในพารามิเตอร์ orders การตอบกลับจัดกลุ่มตามรหัสคำสั่งซื้อ เพื่อให้เอเจนต์ตรวจสอบทั้งแคมเปญในการเรียกรอบเดียวแทนที่จะเรียกทีละคำสั่งซื้อ

คำขอ

key=YOUR_API_KEY
action=status
orders=23501,23502,23503

การตอบกลับ

{
  "23501": {
    "charge": "0.90",
    "start_count": "4250",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "23502": {
    "charge": "9.00",
    "start_count": "1200",
    "status": "In progress",
    "remains": "500",
    "currency": "USD"
  },
  "23503": {
    "error": "Incorrect order ID"
  }
}

6. เติมคืน

ขอเติมคืนคำสั่งซื้อที่บริการรองรับ (refill: true ในรายการบริการ) และส่งคืนรหัสเติมคืนเพื่อติดตาม ส่ง order รายการเดียวหรือรายการ orders ที่คั่นด้วยเครื่องหมายจุลภาค เพื่อให้เอเจนต์สามารถขอเติมคืนเป็นชุดได้หลังจากการตรวจสอบสถานะพบยอดตก

คำขอ (รายการเดียว)

key=YOUR_API_KEY
action=refill
order=23501

การตอบกลับ

{
  "refill": 4001
}

คำขอ (หลายรายการ)

key=YOUR_API_KEY
action=refill
orders=23501,23502

การตอบกลับ

[
  { "order": 23501, "refill": 4001 },
  { "order": 23502, "refill": { "error": "Refill not available" } }
]

7. ยกเลิก

ขอยกเลิกคำสั่งซื้อที่ยังไม่ได้ดำเนินการ (บริการที่มี cancel: true) ส่งรายการ orders ที่คั่นด้วยเครื่องหมายจุลภาค การตอบกลับจะรายงานผลลัพธ์ต่อคำสั่งซื้อ เป็นการเลิกทำที่เอเจนต์ใช้เมื่อมีบางอย่างถูกจัดคิวโดยผิดพลาด

คำขอ

key=YOUR_API_KEY
action=cancel
orders=23501,23502

การตอบกลับ

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Incorrect order ID" } }
]

8. ยอดเงิน

ส่งคืนยอดเงินและสกุลเงินในบัญชีของคุณ เอเจนต์อ่านค่านี้เพื่อควบคุมการใช้จ่ายก่อนสั่งซื้อ และแผงควบคุมของคุณอ่านเพื่อแสดงเงินทุน เป็นการเรียกที่ประหยัดที่สุดเพื่อยืนยันว่ามีเงินให้ใช้จ่าย

คำขอ

key=YOUR_API_KEY
action=balance

การตอบกลับ

{
  "balance": "182.45",
  "currency": "USD"
}

เรียกใช้จากอะไรก็ได้

หนึ่งเอนด์พอยต์ พารามิเตอร์ฟอร์มธรรมดา ดังนั้นเชลล์ cron job หรือเอเจนต์จึงขับเคลื่อนได้ในแบบเดียวกัน นี่คือคำสั่งซื้อฉบับสมบูรณ์ที่สั่งจากบรรทัดคำสั่ง:

curl -X POST https://api.socialgo.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/example" \
  -d "quantity=1000"

หมายเหตุและแนวทางปฏิบัติที่ดี

• อ่านก่อนเขียน เรียก services (หรือ balance) เพื่อยืนยันอัตรา ขีดจำกัด และเงินทุน แล้วจึงเรียก add เป็นกลไกป้องกัน ค้นหาแล้วลงมือ เดียวกับที่แดชบอร์ดและเซิร์ฟเวอร์ MCP ใช้ เพื่อไม่ให้มีการใช้จ่ายโดยไม่มีการยืนยันราคา
• แคชรายการบริการและรีเฟรชเป็นระยะ เพราะรหัส อัตรา และขีดจำกัดมีการเปลี่ยนแปลง
• ตรวจสอบจำนวน min/max ก่อนส่งคำสั่งซื้อเพื่อหลีกเลี่ยงการเรียกที่ถูกปฏิเสธ
• ตรวจสอบสถานะเป็นชุดด้วยการเรียกแบบหลายคำสั่งซื้อแทนที่จะเรียกทีละคำสั่งซื้อ
• เก็บคีย์ของคุณไว้ฝั่งเซิร์ฟเวอร์ หากถูกเปิดเผยเมื่อใด ให้หมุนเวียนทันทีจากแดชบอร์ด