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

การตรวจสอบสิทธิ์ด้วย API keys

ทุก endpoint ยกเว้นสอง endpoint ราคาต้องการ API key ในส่วนหัว Authorization

POST /v1/messages HTTP/1.1
Host: bulksmsapi.cc
Authorization: Bearer bsa_live_7QzX2mW9kR4tB8nV1cJ6yP3sH5dL0aFe
Content-Type: application/json

การสร้างคีย์

คีย์ถูกสร้างในหน้า API keys ของคอนโซล หน้าเปิดหลังจากเติมเงินครั้งแรกเข้าบัญชี
บัญชีหนึ่งสามารถมีคีย์ที่ใช้งานได้ 10 คีย์ ให้แต่ละแอปหรือสภาพแวดล้อมมีคีย์และชื่อของตัวเอง เพื่อให้สามารถแทนที่หนึ่งโดยไม่กระทบกับคีย์อื่น
คีย์คือ bsa_live_ ตามด้วยตัวอักษรและตัวเลข 32 ตัว มันจะแสดงเพียงครั้งเดียวเมื่อถูกสร้าง เราจะเก็บเฉพาะแฮชที่ใช้คีย์ ดังนั้นคีย์ที่สูญหายจะไม่สามารถแสดงอีกได้ ให้สร้างใหม่แทน
รายการแสดงตัวอักษรแรก สี่ตัวสุดท้าย เมื่อคีย์ถูกสร้างและเมื่อถูกใช้ล่าสุด

การหมุนเวียนและยกเลิก

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

การรักษาคีย์ให้ปลอดภัย

เรียกใช้ API จากเซิร์ฟเวอร์ของคุณ อย่าเรียกจากบราวเซอร์หรือแอปมือถือ: ใครก็ตามที่มีคีย์สามารถส่งข้อความจากยอดเงินของคุณ
เก็บคีย์ในตัวแปรสภาพแวดล้อมหรือตัวจัดการความลับ ไม่ใช่ใน source control
แต่ละคีย์มีตัวนับ rate limit ของตัวเอง ดังนั้น worker ที่ยุ่งจะไม่ทำให้คีย์ที่สองที่ใช้ที่อื่นช้าลง

ข้อผิดพลาด

401 UnauthorizedJSON

{
  "error": {
    "code": "unauthorized",
    "message": "Send your API key as Authorization: Bearer bsa_live_... Keys are created in the console under API keys.",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#unauthorized"
  }
}

ก่อนหน้าเริ่มต้นเร็ว ถัดไปข้อความ