นักพัฒนา

GET/v3/get_supporting_document_templates/{iso}

แสดงรายการแม่แบบเอกสารประกอบ

ค้นหา ID แม่แบบ ชื่อ และข้อมูลบ่งชี้ประเทศก่อนจัดเตรียมเอกสารประกอบ

ในหน้านี้
  1. เรียกดูรายการแม่แบบ
  2. ใช้ข้อกำหนดในการเลือกแม่แบบ
  3. หากไม่มีแม่แบบส่งกลับมา
  4. ตรวจสอบสำเนาที่ดาวน์โหลดก่อนใช้งาน
  5. คำขอ
  6. การตอบกลับ
  7. ข้อผิดพลาด
  8. ความพร้อมใช้งานและผลข้างเคียง

เรียกดูรายการแม่แบบ

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

ใช้ข้อกำหนดในการเลือกแม่แบบ

การมีแม่แบบอยู่ในรายการไม่ได้หมายความว่าแม่แบบนั้นจำเป็นหรือได้รับการยอมรับสำหรับหมายเลขทุกหมายเลขในประเทศนั้น จับคู่ ID แม่แบบกับข้อกำหนดเอกสารประกอบที่ใช้บังคับ รายการนี้ไม่ได้สร้าง ลงนาม อัปโหลด หรืออนุมัติเอกสารที่กรอกเสร็จแล้ว

หากไม่มีแม่แบบส่งกลับมา

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

ตรวจสอบสำเนาที่ดาวน์โหลดก่อนใช้งาน

ลิงก์ดาวน์โหลดในรายการอาจส่งกลับสำเนาที่มีการเปลี่ยนแปลงรูปแบบหรือองค์ประกอบแบรนด์ อย่าถือว่าสำเนานั้นเป็นข้อตกลงต้นฉบับที่ไม่มีการเปลี่ยนแปลง หรือถือว่าการดาวน์โหลดทำให้ปฏิบัติตามข้อกำหนดการลงทะเบียนครบถ้วนแล้ว ตรวจสอบเนื้อหาก่อนกรอกหรือลงนามในเอกสารใด ๆ

หากเครื่องมือช่วยจัดเตรียมเอกสารในพอร์ทัลมีบริการจัดเตรียมข้อตกลง ให้ใช้การแสดงตัวอย่างและขั้นตอนการส่งเอกสารที่ต้องดำเนินการอย่างชัดเจนของเครื่องมือนั้น สำหรับแบบฟอร์มอื่นที่จำเป็น ให้ยืนยันแบบฟอร์มฉบับปัจจุบันกับ MultiTEL ก่อนกรอก แม่แบบที่ดาวน์โหลดไม่ใช่เอกสารแนบที่ลงนามแล้ว หลักฐานที่อัปโหลดแล้ว หรือการอนุมัติหมายเลข

คำขอ

ใช้ข้อมูลรับรองของบัญชี API ที่เปิดใช้งานแล้วผ่าน HTTPS รองรับการยืนยันตัวตนแบบ Basic และโทเค็น bearer ของบัญชี API ที่เปิดใช้งานแล้ว โดยมีข้อจำกัดของบัญชีบังคับใช้

ใช้ GET โดยระบุพารามิเตอร์ใด ๆ ที่อธิบายไว้ในเอกสารในพาธ URL

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_supporting_document_templates/$COUNTRY_ISO"
พารามิเตอร์พาธ
ชื่อชนิดจำเป็นคำอธิบาย
isostringไม่ตัวกรอง ISO ของประเทศที่ไม่บังคับ ละส่วนพาธนี้ทั้งส่วนเพื่อรับรายการที่ไม่ได้กรอง การเปรียบเทียบไม่แยกตัวพิมพ์ใหญ่และตัวพิมพ์เล็ก ค่าที่ไม่รู้จักหรือไม่ตรงกันจะทำให้ส่งกลับรายการว่าง แทนที่จะส่งข้อผิดพลาดที่ระบุชัดเจนว่าประเทศไม่ถูกต้อง

การตอบกลับ

ตรวจสอบ status.code ในเนื้อหา JSON ควบคู่กับสถานะ HTTP โดย response เป็นอาร์เรย์ของออบเจ็กต์ที่มี id, name, permanent, iso และ url ส่วน permanent มีชนิดเป็น boolean และ iso อาจเป็นค่าว่างและอาจอนุมานมาจากชื่อแม่แบบ ให้ถือว่าข้อมูลประเทศเป็นเพียงข้อมูลบ่งชี้ ไม่ใช่การตัดสินคุณสมบัติในการใช้งาน รายการแม่แบบที่ว่างเปล่าถือเป็นการตอบกลับสำเร็จด้วยสถานะ 200 และอาจเกิดขึ้นได้เช่นกันเมื่อการค้นหาในระบบต้นทางไม่พบข้อมูล URL สร้างขึ้นโดยบริการ และชื่อโฮสต์อาจแตกต่างจากตัวอย่างประกอบ

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "TEMPLATE_ID_FROM_RESPONSE",
      "name": "Example supporting-document template",
      "permanent": false,
      "iso": "US",
      "url": "https://api.multitel.net/v3/supporting_document/TEMPLATE_ID_FROM_RESPONSE"
    }
  ]
}

ข้อผิดพลาด

  • ตรวจสอบ status.code และ status.msg เพื่อดูข้อผิดพลาดในการยืนยันตัวตนหรือข้อผิดพลาดของบริการ การตอบกลับสำเร็จที่มีรายการแม่แบบว่างเปล่าไม่ใช่การอนุมัติเอกสารหรือการยกเว้นการลงทะเบียน

ความพร้อมใช้งานและผลข้างเคียง

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