2.12 เปลี่ยนข้อมูลการสมัครสมาชิก SSL

2.12.1 ข้อมูล API

สภาพแวดล้อมทดสอบ
สภาพแวดล้อมจริง	https://portal.racent.com/ssl/replace
วิธีการร้องขอ	POST
content-type	multipart/form-data
คำอธิบาย	API นี้ใช้สำหรับแทนที่ข้อมูลการสมัครสมาชิก SSL เกี่ยวข้องกับใบรับรอง SSL เท่านั้น อนุญาตให้แทนที่ข้อมูลการสมัครสมาชิก SSL ได้เฉพาะเมื่อสถานะการสมัครสมาชิก SSL เป็นออกใบรับรองแล้วเท่านั้น

2.12.2 การกำหนดพารามิเตอร์

ชื่อพารามิเตอร์	ประเภทพารามิเตอร์	จำเป็น	คำอธิบาย
api_token	String	Y	ข้อมูลประจำตัวสำหรับการยืนยันตัวตน โปรดติดต่อฝ่ายสนับสนุนทางเทคนิคของ Racent เพื่อสร้าง token
certId	String	Y	รหัสใบรับรอง racent
refId	String	N	หมายเลขคำสั่งซื้อเฉพาะที่ลูกค้าเป็นผู้ให้
domainVerificationPic	File	N	เมื่อวิธีการยืนยันโดเมนคือ VERIFY_DOCUMENT รายการนี้จะเป็น Y ใช้สำหรับการยืนยันความเป็นเจ้าของโดเมน (ปัจจุบันรองรับเฉพาะ CFCA)
params	String	Y	ข้อมูลสำหรับการแทนที่ รายละเอียดอธิบายดังนี้
csr	String	Y	หมายเหตุ: โดเมนในข้อมูล CSR ต้องสอดคล้องกับโดเมนใน CSR ของการสมัครสมาชิก SSL เดิม
uniqueValue	String	N	เกี่ยวข้องกับผลิตภัณฑ์ Sectigo เท่านั้น อักขระ 1-20 ตัว (a-z A-Z 0-9) ใช้สำหรับผู้จัดจำหน่ายสร้างค่ายืนยันด้วยตนเอง
dcvMethod	String	N	ตั้งค่าวิธีการยืนยันโดเมนที่ยื่นคำขอโดยรวม ต้องเป็นหนึ่งในสี่วิธีต่อไปนี้: EMAIL (ยืนยันทางอีเมล) HTTP_CSR_HASH (ยืนยันด้วยไฟล์) CNAME_CSR_HASH (ยืนยันด้วย DNS) HTTPS_CSR_HASH (ยืนยันด้วยไฟล์ https) VERIFY_DOCUMENT (หลักฐานใบรับรองโดเมน รองรับเฉพาะ CFCA) สำหรับ CFCA รายการนี้คือ Y
domainInfo	String	Y	ข้อมูลโดเมน ตัวอย่าง: [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] คำอธิบายโดยละเอียดดังนี้:
dcvMethod	String	Y	วิธีการตรวจสอบสิทธิ์โดเมน ต้องเป็นหนึ่งในสี่วิธีต่อไปนี้: EMAIL (การตรวจสอบทางอีเมล) HTTP_CSR_HASH (การตรวจสอบไฟล์) CNAME_CSR_HASH (การตรวจสอบ DNS) HTTPS_CSR_HASH (การตรวจสอบไฟล์ https) เมื่อ dcvMethod ระดับบนไม่มีอยู่ รายการนี้จะเป็น Y เมื่อ dcvMethod ระดับบนมีอยู่และรายการนี้มีอยู่ด้วย จะให้ความสำคัญกับ dcvMethod ระดับบน
dcvEmail	String	N	อีเมลสำหรับตรวจสอบสิทธิ์โดเมน เมื่อรายการนี้เป็น N ค่าเริ่มต้นเมื่อละไว้มีดังนี้ racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	Y	โดเมน
organizationInfo	String	N	เมื่อคุณต้องการเปลี่ยนแปลงข้อมูลบริษัท พารามิเตอร์นี้จะเป็น Y
organizationCity	String	N	เมืองที่บริษัทตั้งอยู่
organizationName	String	N	ชื่อบริษัท
organizationMobile	String	N	เบอร์โทรศัพท์บริษัท
organizationAddress	String	N	ที่อยู่บริษัท
organizationCountry	String	N	ประเทศที่บริษัทตั้งอยู่ (รหัสสองตัวอักษรตามมาตรฐาน ISO 3166-1)
organizationPostCode	String	N	รหัสไปรษณีย์ของที่ตั้งบริษัท

ค่าที่ฟังก์ชันส่งกลับ

ชื่อพารามิเตอร์	ประเภทพารามิเตอร์	บังคับ	คำอธิบาย
code	Int	Y	สถานะการตอบกลับ โปรดดูรายละเอียดเพิ่มเติมในภาคผนวก 3.1
errors	Object or String	N	เมื่อสถานะการตอบกลับเป็นข้อผิดพลาด ข้อมูลข้อผิดพลาดเฉพาะ
data	Object	N	เมื่อสถานะการตอบกลับสำเร็จ พารามิเตอร์นี้คือ Y คำอธิบายโดยละเอียดดังนี้:
certId	String	N	racent certificate id โปรดเก็บรักษาให้ดี พารามิเตอร์นี้คือข้อมูลประจำตัวเฉพาะของอินสแตนซ์ racent
vendorId	String	N	หมายเลขคำสั่งซื้อ CA
vendorCertId	String	N	หมายเลขใบรับรอง CA
DCVfileName	String	N	ชื่อไฟล์สำหรับการตรวจสอบสิทธิ์แบบไฟล์
DCVfileContent	String	N	เนื้อหาไฟล์สำหรับการตรวจสอบสิทธิ์แบบไฟล์
DCVdnsHost	String	N	ค่าโฮสต์สำหรับการตรวจสอบสิทธิ์แบบ DNS
DCVdnsValue	String	N	ค่าระเบียนสำหรับการตรวจสอบสิทธิ์แบบ DNS
DCVdnsType	String	N	ประเภทระเบียนสำหรับการตรวจสอบสิทธิ์แบบ DNS
DCVfilePath	String	N	เส้นทางไฟล์สำหรับการตรวจสอบสิทธิ์แบบไฟล์
dcvInfo	Object	N	เมื่อค่าโดเมนในการตรวจสอบความถูกต้องของแต่ละโดเมนในใบรับรองที่ยื่นขอไม่เหมือนกัน รายการนี้จะเป็น Y แต่ละรายการมีชนิดเป็น Object ชื่อออบเจกต์ของแต่ละรายการคือโดเมนที่ยื่นขอ เช่น racent.com รายละเอียดแต่ละรายการมีดังนี้:
DCVfileName	String	N	เนื้อหาไฟล์สำหรับการตรวจสอบด้วยไฟล์
DCVfileContent	String	N	เนื้อหาไฟล์สำหรับการตรวจสอบด้วยไฟล์
DCVdnsHost	String	N	ค่าโฮสต์สำหรับการตรวจสอบด้วย Dns
DCVdnsValue	String	N	ค่าระเบียนสำหรับการตรวจสอบด้วย Dns
DCVdnsType	String	N	ชนิดระเบียนสำหรับการตรวจสอบด้วย Dns
DCVfilePath	String	N	เส้นทางไฟล์สำหรับการตรวจสอบด้วยไฟล์