เทมเพลต&รหัสผู้ส่ง

เอกสารนี้อธิบายอินเทอร์เฟซ RESTful API ที่เกี่ยวข้องกับการกำหนดค่ารูปแบบและการกำหนดค่าลายเซ็น

ข้อมูลพื้นฐาน

• โดเมน: https://smsapi.engagelab.com
• วิธีการตรวจสอบสิทธิ์: Basic Authentication (การเข้ารหัส Base64)
  • รูปแบบ: Authorization: Basic base64(apikey:apisecret)
  • ตัวอย่าง: เข้ารหัส apikey:apisecret ด้วย Base64 จากนั้นเพิ่ม Authorization: Basic <encoded string> ในส่วนหัวของคำขอ
• Content-Type: application/json

รูปแบบการตอบกลับ

การตอบกลับที่สำเร็จ

การตอบกลับที่สำเร็จจะคืนวัตถุข้อมูลหรืออาร์เรย์โดยตรง:

              
              {
  "template_id": "123456789",
  "template_name": "Example Template",
  ...
}

            

หรือการตอบกลับแบบรายการ:

              
              [
  {
    "template_id": "123456789",
    "template_name": "Example Template",
    ...
  }
]

            

การตอบกลับข้อผิดพลาด

รูปแบบการตอบกลับข้อผิดพลาด:

              
              {
  "code": 400,
  "message": "Error description"
}

            

อินเทอร์เฟซการกำหนดค่ารูปแบบ

1. รับรายการการกำหนดค่ารูปแบบ

คำอธิบายอินเทอร์เฟซ: ดึงรายการการกำหนดค่ารูปแบบทั้งหมดภายใต้ธุรกิจปัจจุบัน

ข้อมูลคำขอ:

• วิธีการ: GET
• เส้นทาง: /v1/template-configs
• การตรวจสอบสิทธิ์: จำเป็น

พารามิเตอร์คำขอ: ไม่มี

ตัวอย่างการตอบกลับ:

              
              [
  {
    "template_id": "123456789",
    "template_name": "Order Notification Template",
    "template_type": "utility",
    "template_content": "Your order {order_no} has been shipped and is expected to arrive by {delivery_time}.",
    "country_codes": "CN,US",
    "status": 2,
    "sign_id": "987654321",
    "sign_name": "Company Name",
    "sign_position": 2,
    "sign_status": 2,
    "audit_remark": "",
    "created_time": 1699000000,
    "updated_time": 1699000000
  }
]

            

คำอธิบายฟิลด์การตอบกลับ:

2. รับรายละเอียดการกำหนดค่ารูปแบบ

คำอธิบายอินเทอร์เฟซ: ดึงข้อมูลรายละเอียดของการกำหนดค่ารูปแบบตามรหัสรูปแบบ

ข้อมูลคำขอ:

• วิธีการ: GET
• เส้นทาง: /v1/template-configs/:templateId
• การตรวจสอบสิทธิ์: จำเป็น

พารามิเตอร์เส้นทาง:

ตัวอย่างการตอบกลับ:

              
              {
  "template_id": "123456789",
  "template_name": "Order Notification Template",
  "template_type": "utility",
  "template_content": "Your order {order_no} has been shipped and is expected to arrive by {delivery_time}.",
  "country_codes": "CN,US",
  "status": 2,
  "sign_id": "987654321",
  "sign_name": "Company Name",
  "sign_position": 2,
  "sign_status": 2,
  "audit_remark": "",
  "created_time": 1699000000,
  "updated_time": 1699000000
}

            

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบรหัสรูปแบบผิดพลาดหรือไม่มีรูปแบบ
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

3. สร้างการกำหนดค่ารูปแบบ

คำอธิบายอินเทอร์เฟซ: สร้างการกำหนดค่ารูปแบบใหม่

ข้อมูลคำขอ:

• วิธีการ: POST
• เส้นทาง: /v1/template-configs
• การตรวจสอบสิทธิ์: จำเป็น

เนื้อหาคำขอ:

              
              {
  "template_name": "Order Notification Template",
  "template_type": "utility",
  "template_content": "Your order {order_no} has been shipped and is expected to arrive by {delivery_time}.",
  "country_codes": "CN,US",
  "add_signature": true,
  "sign_id": "987654321",
  "sign_position": 2
}

            

คำอธิบายฟิลด์คำขอ:

ตัวอย่างการตอบกลับ:

              
              {
  "template_id": "123456789"
}

            

คำอธิบายฟิลด์การตอบกลับ:

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบพารามิเตอร์ผิดพลาด, การตรวจสอบพารามิเตอร์ล้มเหลว, ไม่มีการกำหนดค่าลายเซ็น, สถานะลายเซ็นไม่ได้รับการอนุมัติ
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

กฎธุรกิจ:

• รูปแบบจะอยู่ในสถานะ "รอการตรวจสอบ" (status=1) หลังจากการสร้าง
• หากเพิ่มลายเซ็น, ลายเซ็นต้องอยู่ในสถานะที่ได้รับการอนุมัติ

4. อัปเดตการกำหนดค่ารูปแบบ

คำอธิบายอินเทอร์เฟซ: อัปเดตการกำหนดค่ารูปแบบที่มีอยู่

ข้อมูลคำขอ:

• วิธีการ: PUT
• เส้นทาง: /v1/template-configs/:templateId
• การตรวจสอบสิทธิ์: จำเป็น

พารามิเตอร์เส้นทาง:

เนื้อหาคำขอ: เหมือนกับอินเทอร์เฟซการสร้าง, ทุกฟิลด์จำเป็น

ตัวอย่างการตอบกลับ:

              
              {
  "code": 0,
  "message": "success"
}

            

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบพารามิเตอร์ผิดพลาด, ไม่มีรูปแบบ, รูปแบบในสถานะรอการตรวจสอบไม่สามารถอัปเดตได้, แผนในสถานะรอหรือกำลังทำงานไม่สามารถอัปเดตได้, ไม่มีการกำหนดค่าลายเซ็น, สถานะลายเซ็นไม่ได้รับการอนุมัติ
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

กฎธุรกิจ:

• รูปแบบในสถานะรอการตรวจสอบไม่สามารถอัปเดตได้
• หากมีแผนข้อความในสถานะรอหรือกำลังทำงานที่ใช้รูปแบบนั้น, จะไม่สามารถอัปเดตได้
• หลังจากการอัปเดต, สถานะของรูปแบบจะกลับไปเป็น "รอการตรวจสอบ" (status=1)

5. ลบการกำหนดค่ารูปแบบ

คำอธิบายอินเทอร์เฟซ: ลบการกำหนดค่ารูปแบบที่ระบุ

ข้อมูลคำขอ:

• วิธีการ: DELETE
• เส้นทาง: /v1/template-configs/:templateId
• การตรวจสอบสิทธิ์: จำเป็น

พารามิเตอร์เส้นทาง:

ตัวอย่างการตอบกลับ:

              
              {
  "code": 0,
  "message": "success"
}

            

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบรหัสรูปแบบผิดพลาด, ไม่มีรูปแบบ, แผนในสถานะรอหรือกำลังทำงานไม่สามารถลบได้
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

กฎธุรกิจ:

• หากมีแผนข้อความในสถานะรอหรือกำลังทำงานที่ใช้รูปแบบนั้น, จะไม่สามารถลบได้

อินเทอร์เฟซการกำหนดค่าลายเซ็น

1. รับรายการการกำหนดค่าลายเซ็น

คำอธิบายอินเทอร์เฟซ: ดึงรายการการกำหนดค่าลายเซ็นทั้งหมดภายใต้ธุรกิจปัจจุบัน

ข้อมูลการร้องขอ:

• วิธี: GET
• เส้นทาง: /v1/sign-configs
• การยืนยันตัวตน: จำเป็น

พารามิเตอร์การร้องขอ: ไม่มี

ตัวอย่างการตอบกลับ:

              
              [
  {
    "sign_id": "987654321",
    "sign_name": "ชื่อบริษัท",
    "status": 2,
    "related_template_count": 5,
    "audit_remark": "",
    "created_time": 1699000000,
    "updated_time": 1699000000
  }
]

            

คำอธิบายฟิลด์การตอบกลับ:

2. รับรายละเอียดการกำหนดค่าลายเซ็น

คำอธิบายอินเทอร์เฟซ: ดึงข้อมูลรายละเอียดของการกำหนดค่าลายเซ็นโดยใช้รหัสลายเซ็น

ข้อมูลการร้องขอ:

• วิธี: GET
• เส้นทาง: /v1/sign-configs/:signId
• การยืนยันตัวตน: จำเป็น

พารามิเตอร์เส้นทาง:

ตัวอย่างการตอบกลับ:

              
              {
  "sign_id": "987654321",
  "sign_name": "ชื่อบริษัท",
  "status": 2,
  "related_template_count": 5,
  "audit_remark": "",
  "created_time": 1699000000,
  "updated_time": 1699000000
}

            

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบรหัสลายเซ็นไม่ถูกต้อง, ลายเซ็นไม่มีอยู่, หรือลายเซ็นไม่ได้เป็นของธุรกิจปัจจุบัน
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

3. สร้างการกำหนดค่าลายเซ็น

คำอธิบายอินเทอร์เฟซ: สร้างการกำหนดค่าลายเซ็นใหม่

ข้อมูลการร้องขอ:

• วิธี: POST
• เส้นทาง: /v1/sign-configs
• การยืนยันตัวตน: จำเป็น

เนื้อหาการร้องขอ:

              
              {
  "sign_name": "ชื่อบริษัท"
}

            

คำอธิบายฟิลด์การร้องขอ:

ตัวอย่างการตอบกลับ:

              
              {
  "sign_id": "987654321"
}

            

คำอธิบายฟิลด์การตอบกลับ:

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบพารามิเตอร์ผิดพลาด, การตรวจสอบพารามิเตอร์ล้มเหลว, หรือชื่อลายเซ็นมีอยู่แล้ว
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

กฎทางธุรกิจ:

• สถานะของลายเซ็นหลังการสร้างคือ "รอการตรวจสอบ" (status=1)
• ชื่อลายเซ็นไม่สามารถซ้ำกันภายในธุรกิจเดียวกันได้

4. อัปเดตการกำหนดค่าลายเซ็น

คำอธิบายอินเทอร์เฟซ: อัปเดตการกำหนดค่าลายเซ็นที่มีอยู่

ข้อมูลการร้องขอ:

• วิธี: PUT
• เส้นทาง: /v1/sign-configs/:signId
• การยืนยันตัวตน: จำเป็น

พารามิเตอร์เส้นทาง:

เนื้อหาการร้องขอ: เหมือนกับอินเทอร์เฟซการสร้าง

ตัวอย่างการตอบกลับ:

              
              {
  "code": 0,
  "message": "success"
}

            

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบพารามิเตอร์ผิดพลาด, ลายเซ็นไม่มีอยู่, ลายเซ็นไม่ได้เป็นของธุรกิจปัจจุบัน, สถานะลายเซ็นอยู่ในระหว่างการตรวจสอบและไม่สามารถอัปเดตได้, ชื่อลายเซ็นมีอยู่แล้ว, หรือมีแผนที่รอดำเนินการหรือกำลังทำงานที่ป้องกันการอัปเดต
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

กฎทางธุรกิจ:

• ลายเซ็นในสถานะรอการตรวจสอบไม่สามารถอัปเดตได้
• หากมีแผนข้อความที่รอดำเนินการหรือกำลังทำงานที่ใช้ลายเซ็นอยู่ จะไม่สามารถอัปเดตได้
• หลังการอัปเดต สถานะลายเซ็นจะกลับไปเป็น "รอการตรวจสอบ" (status=1)

5. ลบการกำหนดค่าลายเซ็น

คำอธิบายอินเทอร์เฟซ: ลบการกำหนดค่าลายเซ็นที่ระบุ

ข้อมูลการร้องขอ:

• วิธี: DELETE
• เส้นทาง: /v1/sign-configs/:signId
• การยืนยันตัวตน: จำเป็น

พารามิเตอร์เส้นทาง:

ตัวอย่างการตอบกลับ:

              
              {
  "code": 0,
  "message": "success"
}

            

การตอบกลับข้อผิดพลาด:

• 400: รูปแบบรหัสลายเซ็นไม่ถูกต้อง, ลายเซ็นไม่มีอยู่, ลายเซ็นไม่ได้เป็นของธุรกิจปัจจุบัน, หรือมีแผนที่รอดำเนินการหรือกำลังทำงานที่ป้องกันการลบ
• 500: ข้อผิดพลาดของเซิร์ฟเวอร์ภายใน

กฎทางธุรกิจ:

• หากมีแผนข้อความที่รอดำเนินการหรือกำลังทำงานที่ใช้ลายเซ็นอยู่ จะไม่สามารถลบได้

คำอธิบายรหัสสถานะ

สถานะการกำหนดค่าเทมเพลต (status)

สถานะการกำหนดค่าลายเซ็น (status)

ตำแหน่งลายเซ็น (sign_position)

ประเภทเทมเพลต (template_type)

คำอธิบายรหัสข้อผิดพลาด

ข้อความข้อผิดพลาดทั่วไป:

• invalid templateId: รูปแบบรหัสเทมเพลตไม่ถูกต้อง
• template config not exist: การกำหนดค่าเทมเพลตไม่มีอยู่
• invalid signId: รูปแบบรหัสลายเซ็นไม่ถูกต้อง
• sign config not exist: การกำหนดค่าลายเซ็นไม่มีอยู่
• sign_name already exist: ชื่อลายเซ็นมีอยู่แล้ว
• can not update pending status template: เทมเพลตในสถานะรอการตรวจสอบไม่สามารถอัปเดตได้
• can not update pending status sign: ลายเซ็นในสถานะรอการตรวจสอบไม่สามารถอัปเดตได้
• there are pending or running plans using current template, can not update: มีแผนที่รอดำเนินการหรือกำลังทำงานที่ใช้เทมเพลตอยู่ ไม่สามารถอัปเดตได้
• there are pending or running plans using current sign, can not update: มีแผนที่รอดำเนินการหรือกำลังทำงานที่ใช้ลายเซ็นอยู่ ไม่สามารถอัปเดตได้
• sign status is not approved, can not use: สถานะลายเซ็นไม่ได้รับการอนุมัติ ไม่สามารถใช้งานได้

หมายเหตุ

1. อินเทอร์เฟซทั้งหมดต้องการการตรวจสอบการยืนยันตัวตน
2. อินเทอร์เฟซทั้งหมดจะเชื่อมโยง ID ธุรกิจของผู้ใช้ที่ยืนยันตัวตนโดยอัตโนมัติ (businessId)
3. การสร้างและการอัปเดตเทมเพลตและลายเซ็นจะเรียกกระบวนการตรวจสอบ
4. หากเทมเพลตหรือลายเซ็นถูกใช้โดยแผนข้อความ จะไม่สามารถอัปเดตหรือลบได้ในขณะที่แผนอยู่ในสถานะรอดำเนินการหรือกำลังทำงาน
5. เนื้อหาเทมเพลตต้องไม่มีอักขระต้องห้าม: 【, 】, 、, 测试, test, [, ]
6. ชื่อลายเซ็นต้องไม่มีอักขระต้องห้าม: 【, 】, [, ]
7. ID ของเทมเพลตและลายเซ็นเป็นสตริงตัวเลข