2.10 ต่ออายุการสมัครใช้งาน SSL

2.10.1 ข้อมูล Api

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

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

ชื่อพารามิเตอร์	ประเภทพารามิเตอร์	จำเป็นต้องระบุ	คำอธิบาย
api_token	String	Y	ข้อมูลประจำตัว สำหรับการสร้าง token กรุณาติดต่อฝ่ายสนับสนุนทางเทคนิคของ Racent
renewId	String	Y	racent certificate id
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	ข้อมูลการสั่งซื้อ คำอธิบายโดยละเอียดดังนี้
csr	String	N	เมื่อพารามิเตอร์ว่างเปล่า จะสร้าง csr ให้คุณ และบันทึกคีย์ส่วนตัว
privateKey	String	N	คีย์ส่วนตัว
server	String	N	เซิร์ฟเวอร์ เกี่ยวข้องกับใบรับรอง SSL เท่านั้น พารามิเตอร์ใบรับรอง SSL เป็น Y ส่วนผลิตภัณฑ์ประเภทอื่นเป็น N หากไม่ต้องการพารามิเตอร์นี้ ให้ระบุเป็น "other" ตามค่าเริ่มต้น
orgCheck	Int	N	ค่าเป็น 0 หรือ 1 เมื่อค่าเป็น 1 ระบบจะค้นหาองค์กรทั้งหมดภายใต้บัญชีของคุณตามข้อมูลองค์กรที่คุณส่ง หากมีอยู่จะใช้ข้อมูลที่เชื่อมโยงขององค์กรนั้น หากไม่มีอยู่เราจะบันทึกเป็นองค์กรใหม่ เมื่อค่าเป็น 0 จะไม่บันทึกข้อมูลองค์กร
duplicateOrgCheck	Int	N	ค่าเป็น 0 หรือ 1 ปัจจุบันพารามิเตอร์นี้เกี่ยวข้องกับใบรับรอง SSL ของ Digicert เท่านั้น ใช้เพื่อระบุว่าจะนำข้อมูลองค์กรและโดเมนที่ผ่านการตรวจสอบก่อนหน้านี้มาใช้ซ้ำหรือไม่ เมื่อค่าเป็น 1 ให้นำมาใช้ซ้ำ เมื่อค่าเป็น 0 ให้สร้างใหม่ ค่าเริ่มต้นคือ 1
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 สำหรับ CFCA รายการนี้คือ 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)
dcvEmail	String	N	อีเมลสำหรับยืนยันโดเมน เมื่อวิธีการยืนยันเป็น EMAIL รายการนี้จะเป็น Y
domainName	String	N	โดเมน
organizationInfo	String	N	ข้อมูลบริษัท เมื่อสั่งซื้อผลิตภัณฑ์ที่ต้องผ่านการตรวจสอบองค์กร พารามิเตอร์นี้เป็น Y สำหรับ CFCA รายการนี้เป็น N ตัวอย่างดังนี้: { "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	รหัสไปรษณีย์สถานที่ตั้งบริษัท
Administrator	String	Y	ข้อมูลผู้ดูแลระบบ ผู้ติดต่อ เมื่อยื่นขอการลงนามโค้ด การลงนามอีเมล หรือการลงนามเอกสาร พารามิเตอร์นี้จะใช้เป็นข้อมูลการยื่นขอ นอกจากนี้ หาก csr เป็น N ข้อมูลนี้จะใช้เป็นข้อมูลสำหรับการสร้าง csr สำหรับ CFCA รายการนี้เป็น N { "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	ชื่อบริษัทของผู้ดูแลระบบ
finance	String		เกี่ยวข้องกับใบรับรอง SSL เท่านั้น ข้อมูลเจ้าหน้าที่ฝ่ายการเงิน สามารถเหมือนกับข้อมูลผู้ดูแลระบบได้ เมื่อสั่งซื้อผลิตภัณฑ์ที่ไม่ใช่ประเภท dv พารามิเตอร์นี้จะเป็น Y สำหรับ CFCA รายการนี้เป็น N { "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	บริษัทของเจ้าหน้าที่การเงิน
tech	String	N	เฉพาะที่เกี่ยวข้องกับใบรับรอง SSL เท่านั้น ข้อมูลเจ้าหน้าที่เทคนิค เมื่อผลิตภัณฑ์ที่สั่งซื้อไม่ใช่ประเภท dv พารามิเตอร์นี้จะเป็น Y สำหรับ CFCA รายการนี้เป็น N { "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	บริษัทของช่างเทคนิค

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

ชื่อพารามิเตอร์	ประเภทพารามิเตอร์	จำเป็น	คำอธิบาย
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	เส้นทางไฟล์สำหรับการตรวจสอบไฟล์