2.1 ตรวจสอบข้อมูล

2.1.1 คำอธิบายอินเทอร์เฟซ

สภาพแวดล้อมทดสอบ
สภาพแวดล้อมจริง	https://portal.racent.com/ssl/validate
วิธีการร้องขอ	POST
content-type	multipart/form-data
คำอธิบาย	อินเทอร์เฟซนี้ใช้สำหรับตรวจสอบข้อมูลการสั่งซื้อทั้งหมดที่คุณส่ง โปรดเรียกอินเทอร์เฟซนี้ก่อนเรียกอินเทอร์เฟซการสั่งซื้อ เพื่อให้การดำเนินการตามคำสั่งซื้อเป็นไปอย่างราบรื่น การตรวจสอบนี้ใช้เพื่อยืนยันข้อมูลบัญชีของคุณ รวมถึงตรวจสอบว่าข้อมูลการสั่งซื้อของคุณถูกต้อง โดยส่งคืนรหัสข้อผิดพลาดที่เกี่ยวข้อง (ดูภาคผนวก 3.1)

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

ชื่อพารามิเตอร์	ประเภทพารามิเตอร์	จำเป็น	คำอธิบาย
api_token	String	Y	โทเค็นผู้ใช้ หากต้องการรับโทเค็น กรุณาติดต่อฝ่ายสนับสนุนทางเทคนิคของ Racent
productCode	String	Y	รหัสผลิตภัณฑ์ ดูวิธีรับรหัสผลิตภัณฑ์ (ดู 2.7)
years	Int	Y	จำนวนปีที่ซื้อ (ปัจจุบันรองรับ 1, 2, 3, 4, 5) ขึ้นอยู่กับผลิตภัณฑ์ที่ระบุ
refId	String	N	หมายเลขคำสั่งซื้อเฉพาะของลูกค้าที่ลูกค้าให้มา
verificationPic	File	N	เอกสารยืนยันสำรอง ใช้สำหรับการยืนยันองค์กร รองรับรูปแบบ .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf ขนาดไม่เกิน 2M
domainVerificationPic	File	N	เมื่อวิธีการยืนยันโดเมนคือ VERIFY_DOCUMENT รายการนี้เป็น Y ใช้สำหรับการยืนยันความเป็นเจ้าของโดเมน (ปัจจุบันรองรับเฉพาะ CFCA)
params	String	Y	ข้อมูลการสั่งซื้อ (สตริง JSON) คำอธิบายโดยละเอียดดังนี้
csr	String	N	เมื่อพารามิเตอร์ว่างเปล่า จะสร้าง CSR ให้คุณ และบันทึกคีย์ส่วนตัว
privateKey	String	N	คีย์ส่วนตัว
server	String	N	เซิร์ฟเวอร์ เกี่ยวข้องกับใบรับรอง SSL เท่านั้น พารามิเตอร์ใบรับรอง SSL คือ Y ส่วนพารามิเตอร์ผลิตภัณฑ์ประเภทอื่นคือ N หากไม่ต้องการพารามิเตอร์นี้ โปรดใช้ค่าเริ่มต้น "other"
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	N	ข้อมูลโดเมน เกี่ยวข้องกับใบรับรอง SSL เท่านั้น พารามิเตอร์ใบรับรอง SSL เป็น Y ส่วนพารามิเตอร์ประเภทอื่นเป็น N ตัวอย่าง: [ { "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	N	วิธีการตรวจสอบโดเมน ต้องเป็นหนึ่งในสี่วิธีต่อไปนี้: 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	N	โดเมน
organizationInfo	String	N	ข้อมูลบริษัท เมื่อสั่งซื้อผลิตภัณฑ์ที่ต้องมีการตรวจสอบองค์กร พารามิเตอร์นี้จะเป็น Y ตัวอย่างดังนี้: { "organizationCity": "เซี่ยงไฮ้", "organizationName": "บริษัทหนึ่ง", "organizationMobile": "18111111111", "organizationAddress": "ถนนเซี่ยงไฮ้", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	เมืองที่บริษัทตั้งอยู่
organizationName	String	N	ชื่อบริษัท
organizationMobile	String	N	โทรศัพท์บริษัท
organizationAddress	String	N	ที่อยู่บริษัท
organizationCountry	String	N	ประเทศที่บริษัทตั้งอยู่ (รหัสสองตัวอักษรตามมาตรฐาน ISO 3166-1)
organizationPostCode	String	N	รหัสไปรษณีย์ของที่ตั้งบริษัท
organizationRegNumber	String	N	หมายเลขใบรับรองของบริษัท สำหรับ CFCA รายการนี้เป็น Y
idType	String	N	ประเภทใบรับรองของบริษัท สำหรับ CFCA รายการนี้เป็น Y ค่ามีดังนี้: TYDMZ: รหัสเครดิตสังคมรวม OTHERS: อื่นๆ
Administrator	string	Y	ข้อมูลผู้ดูแลระบบ ผู้ติดต่อ เมื่อยื่นขอ Code Signing, Email Signing หรือ Document Signing พารามิเตอร์นี้จะใช้เป็นข้อมูลคำขอ นอกจากนี้ หาก csr เป็น N ข้อมูลนี้จะใช้เป็นข้อมูลสำหรับการสร้าง csr { "job": "สำนักงานผู้จัดการทั่วไป", "city": "นครเซี่ยงไฮ้", "email": "xx@yy.com", "state": "นครเซี่ยงไฮ้", "mobile": "18111111111", "address": "นครเซี่ยงไฮ้", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "บริษัทหนึ่ง" }"
job	String	Y	ตำแหน่งงานของผู้ดูแลระบบ
city	String	Y	เมืองที่ผู้ดูแลระบบตั้งอยู่
email	String	Y	อีเมลของผู้ดูแลระบบ
state	String	Y	รัฐหรือมณฑลที่ผู้ดูแลตั้งอยู่
mobile	String	Y	ข้อมูลติดต่อของผู้ดูแล
address	String	Y	ที่อยู่สำหรับติดต่อของผู้ดูแล
country	String	Y	ประเทศของผู้ดูแลระบบ (รหัสสองตัวอักษรตามมาตรฐาน ISO 3166-1)
lastName	String	Y	นามสกุลของผู้ดูแลระบบ
postCode	String	Y	รหัสไปรษณีย์ของที่ตั้งผู้ดูแลระบบ
firstName	String	Y	ชื่อผู้ดูแลระบบ
organation	String	Y	ชื่อบริษัทของผู้ดูแลระบบ
idType	String	N	ประเภทเอกสาร CFCA กำหนดให้ต้องมีรายการนี้ ค่าที่เป็นไปได้ ได้แก่: SFZ: บัตรประชาชน HZ: หนังสือเดินทาง
idNumber	String	N	หมายเลขเอกสารประจำตัว สำหรับ CFCA รายการนี้คือ Y
finance	string		เกี่ยวข้องกับใบรับรอง SSL เท่านั้น ข้อมูลเจ้าหน้าที่ฝ่ายการเงิน สามารถเหมือนกับข้อมูลผู้ดูแลระบบได้ เมื่อผลิตภัณฑ์ที่สั่งซื้อไม่ใช่ประเภท dv พารามิเตอร์นี้คือ Y { "job": "แผนกการเงิน", "city": "เซี่ยงไฮ้", "email": "xx@yy.com", "state": "เซี่ยงไฮ้", "mobile": "18111111111", "address": "เซี่ยงไฮ้", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "บริษัทหนึ่ง" }"
job	String	N	ตำแหน่งงานของเจ้าหน้าที่การเงิน
city	String	N	เมืองที่เจ้าหน้าที่การเงินตั้งอยู่
email	String	N	อีเมลของเจ้าหน้าที่การเงิน
state	String	N	รัฐหรือมณฑลที่เจ้าหน้าที่การเงินตั้งอยู่
mobile	String	N	ข้อมูลติดต่อเจ้าหน้าที่การเงิน
address	String	N	ที่อยู่ติดต่อเจ้าหน้าที่การเงิน
country	String	N	ประเทศของเจ้าหน้าที่การเงิน (รหัสสองตัวอักษรตามมาตรฐาน ISO 3166-1)
lastName	String	N	นามสกุลของเจ้าหน้าที่การเงิน
postCode	String	N	รหัสไปรษณีย์ของที่ตั้งเจ้าหน้าที่การเงิน
firstName	String	N	ชื่อเจ้าหน้าที่การเงิน
organation	String	N	บริษัทของเจ้าหน้าที่การเงิน
idType	String	N	ประเภทเอกสารระบุตัวตน สำหรับ CFCA รายการนี้คือ Y ค่ามีดังนี้: SFZ: บัตรประชาชน HZ: หนังสือเดินทาง
idNumber	String	N	หมายเลขเอกสารประจำตัว สำหรับ CFCA รายการนี้คือ Y
tech	string	N	เกี่ยวข้องกับใบรับรอง SSL เท่านั้น ข้อมูลเจ้าหน้าที่เทคนิค เมื่อสินค้าที่สั่งซื้อไม่ใช่ประเภท dv พารามิเตอร์นี้คือ Y { "job": "แผนกเทคนิค","city": "นครเซี่ยงไฮ้", "email": "xx@yy.com", "state": "นครเซี่ยงไฮ้", "mobile": "18111111111", "address": "นครเซี่ยงไฮ้", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "บริษัทแห่งหนึ่ง" }"
job	String	N	ตำแหน่งของเจ้าหน้าที่เทคนิค
city	String	N	เมืองของช่างเทคนิค
email	String	N	อีเมลของช่างเทคนิค
state	String	N	จังหวัดหรือรัฐของช่างเทคนิค
mobile	String	N	ข้อมูลติดต่อของช่างเทคนิค
address	String	N	ที่อยู่ติดต่อของช่างเทคนิค
country	String	N	ประเทศของช่างเทคนิค (รหัสสองตัวอักษรตามมาตรฐาน ISO 3166-1)
lastName	String	N	นามสกุลของช่างเทคนิค
postCode	String	N	รหัสไปรษณีย์ของที่อยู่ช่างเทคนิค
firstName	String	N	ชื่อของช่างเทคนิค
organation	String	N	บริษัทของช่างเทคนิค
idType	String	N	ประเภทเอกสาร สำหรับ CFCA ฟิลด์นี้คือ Y ค่ามีดังนี้: SFZ: บัตรประชาชน HZ: หนังสือเดินทาง
idNumber	String	N	หมายเลขเอกสาร สำหรับ CFCA ฟิลด์นี้คือ Y

ฟังก์ชันคืนค่า

ชื่อพารามิเตอร์	ประเภทพารามิเตอร์	จำเป็น	คำอธิบาย
code	Int	Y	สถานะการคืนค่า ดูรายละเอียดเพิ่มเติมในภาคผนวก 3.1
errors	Object or String	N	เมื่อสถานะการคืนค่าเป็นข้อผิดพลาด ข้อมูลข้อผิดพลาด

2.1.3 ตัวอย่างคำขอ

请求示例

{
	"years": 2,
	"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
	"api_token": "zzzoooppzz",
	"productCode": "comodo-positivessl"
}