เอกสาร API ของ SMM Panel

ทำไมถึงมี API 2 ชุด?

API สำหรับตัวแทนจำหน่ายแบบคลาสสิก (v2) ที่ใช้กันทั่ววงการจะส่งฟอร์มไปยัง Endpoint เดียว และตอบกลับด้วย HTTP 200 เสมอ ซึ่งตรงกับรูปแบบที่ซอฟต์แวร์พาเนลสำเร็จรูปต้องการพอดี เราจึงคงไว้ตามเดิม แต่นักพัฒนาที่เขียนระบบของตัวเองมักติดข้อจำกัดของ API ชุดนี้ซ้ำ ๆ: แยกแยะข้อผิดพลาดไม่ได้ แคตตาล็อกมาเป็นก้อนเดียว และต้องคอยเช็กสถานะคำสั่งซื้อซ้ำไปเรื่อย ๆ เราจึงสร้าง v3 ขึ้นมาเพื่อนักพัฒนากลุ่มนี้

เปรียบเทียบ

ควรใช้ API ชุดไหน?

เริ่มต้นใช้งาน

1. 1สร้างคีย์ API ในแท็บคีย์ API
2. 2ดึงรายการบริการ แล้วดู id และสคีมาฟิลด์ของบริการที่ต้องการ
3. 3ตรวจสอบคำสั่งซื้อด้วย preview ก่อน แล้วจึงสร้างจริง
4. 4ลงทะเบียน Webhook หรืออ่านสตรีมเหตุการณ์ เพื่อติดตามการเปลี่ยนสถานะ

Base URL

ทุกพาธจะต่อท้าย URL นี้ และเวอร์ชันอยู่ในพาธ หากวันหนึ่งจำเป็นต้องมีการเปลี่ยนแปลงที่ไม่เข้ากันกับของเดิม (breaking change) เราจะเผยแพร่พาธใหม่ (v4) โดยพาธนี้ยังทำงานต่อได้ตามเดิมทุกอย่าง ทุกการตอบกลับจะมีวันที่เผยแพร่ของสัญญา API (contract) อยู่ใน header X-Api-Version

https://panelfollows.com/api/v3

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

ส่งคีย์ API เป็น Bearer token ใน header Authorization หรือจะใช้ header X-Api-Key แทนก็ได้

GET https://panelfollows.com/api/v3/account
Authorization: Bearer pf_live_...

คีย์เดิมของคุณใช้กับ v3 ได้ด้วย จึงลองใช้งานได้ทันที แต่ในระบบใช้งานจริง (production) ควรใช้คีย์ v3 เพราะตั้งชื่อกำกับได้ เพิกถอนแยกทีละคีย์ได้ และไม่มีการเก็บเป็นข้อความธรรมดา (plain text)

เริ่มต้นอย่างรวดเร็ว

curl https://panelfollows.com/api/v3/services?limit=5 \
  -H "Authorization: Bearer YOUR_API_KEY"

ภาษา

เลือกภาษาของการตอบกลับด้วย header Accept-Language หรือพารามิเตอร์ ?lang= หากส่งมาทั้งคู่ ระบบจะใช้ค่าจากพารามิเตอร์ ชื่อบริการ คำอธิบายบริการ ชื่อหมวดหมู่ ป้ายสถานะคำสั่งซื้อ ป้ายฟิลด์คำสั่งซื้อ และข้อความแสดงข้อผิดพลาด จะส่งกลับมาเป็นภาษานั้นทั้งหมด

ค่าสำหรับโปรแกรมไม่เปลี่ยนตามภาษา: error.code / order.status / service.type และ currency มีค่าเหมือนเดิมเสมอ ให้โค้ดตัดสินใจจากค่าเหล่านี้ แล้วนำข้อความไปแสดงให้ผู้ใช้ของคุณ

Accept-Language: tr
# veya
GET https://panelfollows.com/api/v3/services?lang=tr

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

body ของคำขอเป็น JSON (application/json) และรับ form-urlencoded ด้วยสำหรับการทดสอบอย่างรวดเร็ว การตอบกลับเป็น JSON: ทรัพยากรเดี่ยวเป็นออบเจ็กต์ธรรมดา ส่วนรายการจะอยู่ในซองข้อมูล (envelope) ที่มี data / has_more / next_cursor ทุกออบเจ็กต์มีฟิลด์ object ที่บอกประเภทของตัวเอง

จำนวนเงินเป็นสตริงทศนิยม ("1.2340") ไม่ใช่ float กรุณาแปลงเป็นชนิดข้อมูลทศนิยม (decimal) ในฝั่งของคุณ เพื่อไม่ให้เศษทศนิยมหาย สกุลเงินคือ USD

ค่าเวลา (timestamp) ใช้รูปแบบ RFC 3339 (2026-08-21T00:24:45.255Z)

ข้อผิดพลาด

เมื่อคำขอล้มเหลว ระบบจะส่งโค้ดสถานะ HTTP จริง พร้อม body ที่มีออบเจ็กต์ error หนึ่งตัว โค้ดของคุณควรตัดสินใจจาก error.code เพราะค่านี้คงที่และไม่เปลี่ยนตามภาษา

HTTP/1.1 400 Bad Request
Content-Type: application/json
X-Request-Id: req_0c858d8af7f65eca001b2f5a

{
  "object": "error",
  "error": {
    "type": "invalid_request_error",
    "code": "quantity_out_of_range",
    "message": "Miktar, bu servisin izin verdiği aralığın dışında.",
    "param": "quantity",
    "doc_url": "https://panelfollows.com/api-docs#error-quantity_out_of_range",
    "request_id": "req_0c858d8af7f65eca001b2f5a"
  }
}

ขีดจำกัดคำขอ (Rate limit)

จำกัด 600 คำขอต่อนาทีต่อคีย์ และ 900 คำขอต่อนาทีต่อ IP ทุกการตอบกลับมี header RateLimit-Limit / RateLimit-Remaining และ RateLimit-Reset เพื่อให้คุณชะลอความถี่ลงได้ก่อนชนขีดจำกัด หากเกินขีดจำกัดจะได้รับโค้ด 429 พร้อม header Retry-After

การแบ่งหน้า (Pagination)

รายการใช้การแบ่งหน้าแบบ cursor ส่ง limit เพื่อกำหนดขนาดหน้า (สูงสุด 500) และส่ง starting_after เป็น id ของรายการสุดท้ายในหน้าก่อนหน้า เรียกต่อไปเรื่อย ๆ จนกว่า has_more จะเป็น false โดย next_cursor คือ cursor สำหรับการเรียกครั้งถัดไป หาก limit อยู่นอกช่วง ระบบจะไม่ปรับค่าให้เองแบบเงียบ ๆ แต่จะตอบกลับเป็นข้อผิดพลาด เพราะการปรับค่าแบบเงียบ ๆ ทำให้ไคลเอนต์เข้าใจผิดว่าดึงข้อมูลมาครบแล้ว

กันคำสั่งซื้อซ้ำ (Idempotency-Key)

ใส่ header Idempotency-Key ที่เป็นค่าสุ่มเมื่อสร้างคำสั่งซื้อ หากการเชื่อมต่อหลุดแล้วคุณส่งซ้ำด้วยคีย์เดิม ระบบจะไม่สร้างคำสั่งซื้อที่สอง แต่จะส่งการตอบกลับครั้งแรกกลับมาอีกครั้งพร้อม header Idempotent-Replay: true ระบบเก็บบันทึกไว้ 24 ชั่วโมง

หากส่งคีย์เดิมพร้อม body ที่ต่างออกไป จะได้ 409 idempotency_key_reuse ซึ่งแทบทุกครั้งหมายความว่าการสร้างคีย์ฝั่งไคลเอนต์มีปัญหา คำขอที่ล้มเหลวไม่ได้ทำให้คีย์นั้นใช้ไม่ได้ แก้ปัญหาแล้วส่งใหม่ด้วยคีย์เดิมได้เลย

การสร้างคำสั่งซื้อ

curl -X POST https://panelfollows.com/api/v3/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 8f14e45f-ea3a-4b1c-9c1e-2b0d5c6a7e91" \
  -d '{
    "service": 1234,
    "link": "https://instagram.com/username",
    "quantity": 1000
  }'

สคีมาฟิลด์ของบริการ

ทุกบริการเผยแพร่ฟิลด์ที่ต้องใช้ไว้ในอาร์เรย์ fields ได้แก่ ชื่อ ประเภท จำเป็นหรือไม่ ขีดจำกัด รวมถึงป้ายชื่อและคำอธิบายในภาษาของคุณ หากฟิลด์ใดมี determines_quantity เป็น true จำนวนจะคำนวณจากจำนวนบรรทัดในฟิลด์นั้น

// Servisin kendi alan şemasından formu OTOMATİK üretmek:
// hiçbir servis tipini koda gömmeniz gerekmez.
const res = await fetch("https://panelfollows.com/api/v3/services/1234", {
  headers: { Authorization: "Bearer YOUR_API_KEY", "Accept-Language": "tr" },
});
const service = await res.json();

for (const field of service.fields) {
  renderInput({
    name: field.name,
    label: field.label,             // kullanıcının dilinde
    hint: field.description,        // kullanıcının dilinde
    required: field.required,
    type: field.type,               // url | integer | string | text_lines
    min: field.min,
    max: field.max,
    // true ise miktarı bu alanın satır sayısı belirler
    countsLines: field.determines_quantity === true,
  });
}

ออบเจ็กต์บริการ (service)

{
  "object": "service",
  "id": 1234,
  "name": "Instagram Takipçi | Türk | 30 gün telafi",
  "description": "Gerçek hesaplardan Türk takipçi. Başlangıç 0-1 saat.",
  "type": "default",
  "platform": "instagram",
  "category": { "slug": "instagram-takipci", "name": "Instagram Takipçi" },
  "pricing": {
    "rate": "1.2340",
    "currency": "USD",
    "unit": "per_1000",
    "unit_note": "Fiyat 1000 adet içindir."
  },
  "limits": { "min": 100, "max": 100000 },
  "features": { "refill": true, "cancel": false, "dripfeed": true },
  "average_time_seconds": 4320,
  "fields": [
    {
      "name": "link",
      "type": "url",
      "required": true,
      "label": "Bağlantı",
      "description": "Gönderimin yapılacağı profilin herkese açık adresi."
    },
    {
      "name": "quantity",
      "type": "integer",
      "required": true,
      "label": "Miktar",
      "description": "Kaç adet gönderileceği.",
      "min": 100,
      "max": 100000
    }
  ],
  "is_active": true,
  "updated_at": "2026-08-20T09:15:00.000Z"
}

ดูตัวอย่างคำสั่งซื้อ (Dry run)

POST /orders/preview ตรวจสอบคำสั่งซื้อและคำนวณยอดที่จะเรียกเก็บโดยไม่สร้างคำสั่งซื้อจริง ใช้แสดงราคาให้ลูกค้าเห็น และเช็กล่วงหน้าว่ายอดเงินคงเหลือพอหรือไม่ ระบบจะไม่ตัดเงินและไม่ติดต่อผู้ให้บริการใด ๆ

สั่งซื้อหลายรายการในครั้งเดียว (Batch)

POST /orders/batch รับคำสั่งซื้อได้สูงสุด 50 รายการต่อการเรียกหนึ่งครั้ง ระบบประมวลผลตามลำดับ และแต่ละรายการรายงานผลของตัวเอง หากรายการหนึ่งล้มเหลว รายการที่เหลือก็ยังสร้างตามปกติ และคุณจะเห็นชัดเจนว่ารายการไหนล้มเหลวเพราะอะไร

แนบออบเจ็กต์ที่เกี่ยวข้องมาในการตอบกลับ

ส่ง include=service ใน Endpoint ของคำสั่งซื้อ แล้วออบเจ็กต์บริการจะแนบมาในการตอบกลับด้วย ไม่ต้องส่งคำขอที่สอง

คุณภาพบริการและรายการบริการที่ดีที่สุด

ทุกชั่วโมงระบบจะวัดผลแต่ละบริการ: คำสั่งซื้อของเราเองจบลงอย่างไร (เสร็จสิ้น ยกเลิก ค้าง หรือถูกปฏิเสธ) ลูกค้าขอเติมยอดหรือเปิดทิกเก็ตบ่อยแค่ไหน การส่งงานใช้เวลาจริงเท่าไร และต้นทางยังมีบริการนี้อยู่หรือไม่ GET /services/top นำผลการวัดเหล่านี้มาจัดเป็นรายการคัดสรรตามอันดับ ส่วน include=quality จะแนบรายงานเดียวกันเข้ากับออบเจ็กต์บริการใดก็ได้

คะแนน (0-100) คำนวณแบบถ่วงน้ำหนักจาก 5 องค์ประกอบ: ความน่าเชื่อถือ (42%: อัตราสำเร็จโดยประมาณ) ความพึงพอใจ (14%: คิดจากอัตราการร้องเรียน) ความเร็ว (28%: คิดแบบลอการิทึมจากเวลาส่งงานที่ใช้คำนวณ (effective delivery time) โดย 5 นาทีได้คะแนนเต็ม และ 48 ชั่วโมงได้ 0) คะแนนจากระบบตรวจสุขภาพบริการเอง (8%) และปริมาณหลักฐาน (8%) มีโบนัสเล็กน้อยให้บริการที่รับประกันการเติมยอด มาจากต้นทางที่เชื่อถือได้ และอยู่ในแคตตาล็อกมานาน บริการที่อยู่ระหว่างตรวจสอบ ถูกระบบตรวจสุขภาพติดธงไว้ หรือมาจากต้นทางที่อยู่ในช่วงทดลอง (probation) ยังได้รับการคำนวณคะแนน แต่จะไม่ถูกนำไปจัดอันดับ

กรองตามแพลตฟอร์ม slug ของหมวดหมู่ หรือ shelf (เช่น followers / likes / views ซึ่งใช้ค่าเดียวกันทุกแพลตฟอร์ม) เรียงตามคะแนน ความเร็ว ความน่าเชื่อถือ ราคา หรือจำนวนคำสั่งซื้อ และใช้ group_by=category (หรือ platform) คู่กับ per_group เพื่อรับรายการคัดสรรแยกตามหมวดหมู่ได้ในการเรียกครั้งเดียว ตรงกับสิ่งที่หน้าร้านต้องใช้เพื่อติดป้าย 'แนะนำ' ให้บริการในทุกหมวดหมู่

# Instagram takipçi kategorisinde en iyi 5 servis
curl "https://panelfollows.com/api/v3/services/top?category=instagram-followers&limit=5"   -H "Authorization: Bearer YOUR_API_KEY"

# Her kategori için kanıtlı en iyi 3 servis (tek istek)
curl "https://panelfollows.com/api/v3/services/top?group_by=category&per_group=3&min_confidence=medium"   -H "Authorization: Bearer YOUR_API_KEY"

รายการ Endpoint

สคีมา OpenAPI

ข้อกำหนดของทุก Endpoint ในรูปแบบที่เครื่องอ่านได้ นำไฟล์นี้ไปใช้กับตัวสร้างไคลเอนต์ (openapi-generator หรือ Kiota) หรือ Postman แล้วจะได้ไคลเอนต์พร้อมใช้ในภาษาโปรแกรมที่คุณใช้อยู่

https://panelfollows.com/api/v3/openapi.json

คำถามที่พบบ่อย

Endpoint

POST https://panelfollows.com/api/v2
POST https://panelfollows.com/api/v2/tr

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

ทุกคำขอต้องมีพารามิเตอร์ key เก็บคีย์เป็นความลับ และสร้างคีย์ใหม่ทันทีหากคีย์รั่วไหล

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

ส่งคำขอด้วย POST แบบฟอร์ม (application/x-www-form-urlencoded) และการตอบกลับเป็น JSON แม้คำขอล้มเหลวก็ยังได้ HTTP 200 โดยมี { "error": "..." } อยู่ใน body

รองรับอยู่แล้วแต่ไม่เคยระบุในเอกสารมาก่อน: เรียกด้วย GET ได้ และส่ง body เป็น application/json ได้

ขีดจำกัดคำขอ (Rate limit)

จำกัด 240 คำขอต่อนาทีต่อคีย์ และ 300 คำขอต่อนาทีต่อ IP ระบบจะปฏิเสธคำขอที่เกินด้วยโค้ด 429

Action และพารามิเตอร์

ตัวอย่าง

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

# Yanıt: { "order": 23501 }

การตอบกลับเป็นภาษาตุรกี

เติม /tr ต่อท้าย URL เพื่อรับชื่อบริการ หมวดหมู่ สถานะคำสั่งซื้อ และข้อความแสดงข้อผิดพลาดเป็นภาษาตุรกี พารามิเตอร์ action และโครงสร้างการตอบกลับเหมือนเดิมทุกอย่าง และคีย์ของคุณใช้ได้กับทั้งสอง URL ฟิลด์ทางเทคนิค (type / refill_status / currency) ยังคงเป็นภาษาอังกฤษเพื่อให้เข้ากันได้กับมาตรฐาน

ย้ายไปใช้ v3

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

1. 1ย้ายคีย์จากฟิลด์ key ใน body ไปไว้ใน header Authorization: Bearer
2. 2เรียกพาธของทรัพยากรแทน action=... (POST /orders แทน add)
3. 3ตรวจความล้มเหลวจากสถานะ HTTP และ error.code แทนการเช็กว่า "มีฟิลด์ error หรือไม่"
4. 4เทียบสถานะคำสั่งซื้อกับค่าสำหรับเครื่อง ไม่ใช่ข้อความที่แสดงผล
5. 5เพิ่ม Idempotency-Key ตอนสร้างคำสั่งซื้อ
6. 6เปลี่ยนจากการเช็กสถานะซ้ำ ๆ (polling) มาใช้ Webhook

คีย์ v3

สร้างคีย์ได้ตามต้องการ ตั้งชื่อกำกับแต่ละคีย์ และเพิกถอนแยกกันได้ ฝั่งเราเก็บไว้เพียงค่าแฮช (cryptographic digest) ของคีย์เท่านั้น

คีย์เดิม

คีย์เดียวที่ใช้กับ API สำหรับตัวแทนจำหน่ายแบบคลาสสิก (v2) และใช้กับ v3 ได้ด้วย เมื่อสร้างคีย์ใหม่ ค่าเดิมจะใช้ไม่ได้ทันที

ความปลอดภัย

• เก็บคีย์ไว้ในตัวแปรสภาพแวดล้อม (environment variable) ไม่ใช่ในซอร์สโค้ด
• อย่าใส่คีย์ในโค้ดที่รันบนเบราว์เซอร์ ให้ส่งคำขอผ่านเซิร์ฟเวอร์ของคุณเองแทน
• สร้างคีย์แยกสำหรับแต่ละระบบ เพื่อให้การเพิกถอนคีย์หนึ่งไม่กระทบระบบอื่น
• หากสงสัยว่าคีย์รั่วไหล ให้นำคีย์ใหม่ไปติดตั้งใช้งานก่อน แล้วจึงเพิกถอนคีย์เดิม

ทำไมต้องใช้ Webhook?

การเช็กสถานะซ้ำ ๆ (polling) ทั้งช้าและสิ้นเปลือง การถามสถานะคำสั่งซื้อหลายพันรายการทุกนาทีทำให้ขีดจำกัดคำขอหมดเร็ว และคุณก็ยังรู้ความเปลี่ยนแปลงช้าไปหลายนาทีอยู่ดี ด้วย Webhook ความเปลี่ยนแปลงจะมาถึงคุณทันทีที่เกิดขึ้น

การตั้งค่า

1. 1เตรียม URL แบบ https ที่เข้าถึงได้สาธารณะ (ระบบไม่รับที่อยู่ในเครือข่ายภายในหรือเครือข่ายส่วนตัว)
2. 2เพิ่ม URL ด้านล่าง แล้วเก็บรหัสลับสำหรับลงลายเซ็น (signing secret) ที่แสดงเพียงครั้งเดียว
3. 3ตรวจสอบลายเซ็นฝั่งคุณ แล้วตอบกลับด้วย 2xx
4. 4ใช้ปุ่มทดสอบเพื่อยืนยันว่าเส้นทางทั้งหมดทำงานครบตั้งแต่ต้นจนจบ

ข้อมูลที่เราส่ง

POST /hooks/pf HTTP/1.1
Content-Type: application/json
Webhook-Id: evt_7f910fba7cd042ef9d9069ba5c074fa0
Webhook-Timestamp: 1787261223
Webhook-Signature: t=1787261223,v1=9c1e2b0d5c6a7e91...

{
  "object": "event",
  "id": "evt_7f910fba7cd042ef9d9069ba5c074fa0",
  "type": "order.completed",
  "created_at": "2026-08-21T00:27:03.531Z",
  "data": {
    "previous_status": "in_progress",
    "order": {
      "object": "order",
      "id": 23501,
      "status": "completed",
      "status_label": "Tamamlandı",
      "service": 1234,
      "quantity": 1000,
      "start_count": 4210,
      "remains": 0,
      "charge": "1.2340",
      "currency": "USD"
    }
  }
}

การตรวจสอบลายเซ็น

ทุกคำขอมี header Webhook-Signature โดย t คือ timestamp และ v1 คือลายเซ็น ลายเซ็นคือค่า HMAC-SHA256 ของสตริง "<timestamp>.<raw body>" ที่คำนวณด้วยรหัสลับของคุณ

1. 1แยกค่า t และ v1 ออกจาก header
2. 2ตรวจว่า t เก่าไม่เกิน 5 นาที เพื่อป้องกันการส่งซ้ำ (replay)
3. 3คำนวณ HMAC-SHA256 ของ "<t>.<raw body>" ด้วยรหัสลับของคุณ
4. 4เปรียบเทียบกับ v1 แบบ constant time และปฏิเสธคำขอหากไม่ตรงกัน

ตัวอย่างการตรวจสอบ

import crypto from "node:crypto";
import express from "express";

const app = express();
// ÖNEMLİ: imza HAM gövde üzerinden hesaplanır. JSON'a çevirip yeniden
// dizeye dönüştürürseniz boşluklar değişir ve imza tutmaz.
app.post("/hooks/pf", express.raw({ type: "application/json" }), (req, res) => {
  const raw = req.body.toString("utf8");
  const header = req.get("Webhook-Signature") ?? "";
  const m = /t=(\d+),v1=([0-9a-f]+)/.exec(header);
  if (!m) return res.sendStatus(400);

  const [, timestamp, signature] = m;
  // Tekrar saldırısına karşı: 5 dakikadan eski damgayı reddet.
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.sendStatus(400);

  const expected = crypto
    .createHmac("sha256", process.env.WEBHOOK_SECRET)
    .update(`${timestamp}.${raw}`, "utf8")
    .digest("hex");

  const ok =
    expected.length === signature.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  if (!ok) return res.sendStatus(401);

  const event = JSON.parse(raw);
  // 2xx dönmezseniz gönderim artan aralıklarla tekrar denenir.
  res.sendStatus(200);

  if (event.type === "order.completed") {
    // ... siparişi kendi sisteminizde tamamlandı olarak işaretleyin
  }
});

การส่งซ้ำ

ระบบส่งครั้งแรกทันทีที่เกิดเหตุการณ์ หากการตอบกลับไม่ใช่ 2xx หรือเชื่อมต่อไม่สำเร็จ ระบบจะส่งซ้ำหลังจาก 1 นาที 5 นาที 30 นาที 2 ชั่วโมง และ 6 ชั่วโมง ครบ 6 ครั้งแล้วยังไม่สำเร็จ ระบบจะทำเครื่องหมายการส่งนั้นว่าล้มเหลวและแสดงไว้ในบันทึกการส่ง

ประเภทเหตุการณ์

เลือกรับเฉพาะประเภทที่สนใจ หรือรับทั้งหมดก็ได้ การเปลี่ยนสถานะหนึ่งครั้งสร้างเหตุการณ์เพียงหนึ่งรายการ โดยใช้ประเภทที่ตรงกับสถานะใหม่มากที่สุด

หากโฮสต์ Webhook ไม่ได้

อ่านเหตุการณ์ชุดเดียวกันได้ด้วย cursor จาก GET /api/v3/events เหมาะสำหรับตอนพัฒนาบนเครื่องตัวเอง ตอนที่ไม่มี IP คงที่ หรือเมื่ออยู่หลังไฟร์วอลล์

// Webhook kuramıyorsanız (yerelde geliştirme, sabit IP yok) aynı bilgiyi
// imleçle çekebilirsiniz. İmleci kendi tarafınızda saklayın.
let cursor = loadCursor(); // en son işlediğiniz olayın "cursor" değeri

const url = new URL("https://panelfollows.com/api/v3/events");
url.searchParams.set("limit", "100");
if (cursor) url.searchParams.set("starting_after", String(cursor));

const res = await fetch(url, { headers: { Authorization: "Bearer YOUR_API_KEY" } });
const { data, has_more } = await res.json();

for (const event of data) {
  handle(event);        // sizin işleyiciniz
  cursor = event.cursor; // imleci ilerlet
}
saveCursor(cursor);