คำถามที่พบบ่อยเกี่ยวกับ NiceNIC Domain API v2

NiceNIC Domain API v2 เป็น API ที่ใช้ HTTPS และ JSON สำหรับการจัดการโดเมนอัตโนมัติผ่านบัญชี NiceNIC ของคุณ

รองรับเวิร์กโฟลว์หลัก เช่น การตรวจสอบความพร้อมของโดเมน การจดทะเบียน การต่ออายุ การโอนย้าย การสอบถามพอร์ตโฟลิโอ การอัปเดตเนมเซิร์ฟเวอร์และข้อมูลติดต่อ การกำหนดราคา ระเบียน DNS เนมเซิร์ฟเวอร์ย่อย ข้อมูลบัญชี และการดำเนินการที่เกี่ยวข้องกับการปฏิบัติตามข้อกำหนด

ใช้ API เมื่อคุณต้องการเชื่อมต่อบริการโดเมนของ NiceNIC โดยตรงกับเว็บไซต์ แพลตฟอร์มโฮสติ้ง ระบบการเรียกเก็บเงิน เครื่องมือภายใน หรือแอปพลิเคชันอื่นๆ

บัญชี NiceNIC ที่ใช้งานอยู่ทุกบัญชีสามารถใช้ Domain API v2 ได้ การเข้าถึง API มีให้สำหรับทั้งบัญชีตลาด (Market Accounts) และบัญชีตัวแทนจำหน่าย (Reseller Accounts)

คุณไม่จำเป็นต้องเป็นตัวแทนจำหน่ายเพียงเพื่อให้ได้รับการเข้าถึง API ประเภทบัญชียังคงมีผลต่อการกำหนดราคา: การดำเนินการ API ที่ต้องชำระเงินจะใช้ราคาที่กำหนดให้กับบัญชี NiceNIC ที่ส่งคำขอ

เปิดการตั้งค่า API →

ใช่ การเข้าถึง API นั้นฟรี ไม่มีค่าธรรมเนียมแยกสำหรับการเปิดใช้งานการเข้าถึง API หรือการส่งคำขอ API ที่รองรับ

การดำเนินการที่ต้องชำระเงิน เช่น การจดทะเบียนโดเมน การต่ออายุ และการโอนย้าย จะถูกคิดค่าธรรมเนียมตามราคาบัญชีของคุณและกฎระเบียบโดเมนที่เกี่ยวข้อง

ไม่จำเป็น การเข้าถึง API และราคาสำหรับผู้ค้าปลีกแยกจากกัน

คุณสามารถใช้ Domain API v2 กับบัญชี Market ธรรมดาของ NiceNIC ได้ อัปเกรดเป็นบัญชีผู้ค้าปลีกเมื่อราคาสำหรับผู้ค้าปลีกหรือสิทธิประโยชน์อื่น ๆ สำหรับผู้ค้าปลีกเป็นประโยชน์ต่อปริมาณธุรกิจของคุณเท่านั้น

เปรียบเทียบแผนสำหรับผู้ค้าปลีก →

Domain API v2 ใช้โครงสร้าง API ปัจจุบันของ NiceNIC พร้อมคำขอ HTTPS การตอบกลับในรูปแบบ JSON การรับรองความถูกต้องตามส่วนหัวของคำขอ และเอกสารที่จัดกลุ่มตามขั้นตอนการทำงานของโดเมนและบัญชีแต่ละรายการ

หากคุณดูแลการเชื่อมต่อที่สร้างขึ้นบน NiceNIC API เวอร์ชันเก่า โปรดตรวจสอบพารามิเตอร์ของ API v2 และการจัดการการตอบกลับก่อนย้ายการใช้งานจริง แทนที่จะถือว่าทั้งสองเวอร์ชันใช้แทนกันได้

ลงชื่อเข้าสู่บัญชี NiceNIC ของคุณแล้วเปิด การตั้งค่า API คำขอ API v2 ใช้ชื่อผู้ใช้ NiceNIC และ API Secret ของคุณเพื่อการรับรองความถูกต้อง

เปิดการตั้งค่า API →

ใช่. NiceNIC มีแซนด์บ็อกซ์ API สำหรับนักพัฒนาเพื่อทดสอบการผสานรวมก่อนที่จะเชื่อมต่อไปยัง API ที่ใช้งานจริง

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

เปิดแซนด์บ็อกซ์ API →

แซนด์บ็อกซ์ API มีไว้สำหรับการพัฒนาและการทดสอบการผสานรวม ส่วน API ที่ใช้งานจริงใช้สำหรับการดำเนินการโดเมนจริงและคำขอที่เสียค่าใช้จ่ายผ่านบัญชี NiceNIC ของคุณ

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

ส่งคำขอ API ผ่าน HTTPS และรวมชื่อผู้ใช้ NiceNIC และรหัสลับ API ของคุณในส่วนหัว Authorization

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

หากเปิดใช้งานข้อจำกัด IP สำหรับบัญชีของคุณ คำขอจะต้องมาจาก IP เซิร์ฟเวอร์ที่ได้รับอนุญาตด้วย

อ่านเอกสารการรับรองความถูกต้องของ API →

เอนด์พอยต์หลักของ Production API คือ:

https://api.nicenic.net/v2/

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

การตอบกลับของ API v2 ใช้รูปแบบ JSON และพารามิเตอร์คำขอใช้การเข้ารหัส UTF-8

{
  "code": 0,
  "msg": "success",
  "data": {}
}

แอปพลิเคชันของคุณควรตรวจสอบ code และ msg ที่ส่งกลับมา แทนที่จะสมมติว่าการตอบกลับ HTTP ทุกครั้งหมายถึงการดำเนินการโดเมนที่เสร็จสมบูรณ์

ผ่าน API ที่มีเอกสารในปัจจุบัน คุณสามารถทำงานอัตโนมัติในเวิร์กโฟลว์ต่างๆ เช่น การตรวจสอบความพร้อมใช้งานของโดเมน การจดทะเบียน การต่ออายุและการโอนย้าย การแสดงรายการพอร์ตโฟลิโอและรายละเอียดโดเมน การอัปเดตเนมเซิร์ฟเวอร์และข้อมูลติดต่อโดเมน ราคาโดเมน ระเบียน DNS เนมเซิร์ฟเวอร์ย่อย ข้อมูลบัญชี และการตรวจสอบการละเมิดและการปฏิบัติตามข้อกำหนด

เวิร์กโฟลว์เพิ่มเติมมีการอธิบายไว้เป็นรายการในส่วนนำทางของ API

เริ่มต้นด้วยการดำเนินการอ่านที่มีความเสี่ยงต่ำ เช่น การตรวจสอบความพร้อมของโดเมน ราคาโดเมน ยอดเงินในบัญชี และรายการโดเมน

จากนั้นยืนยันการตรวจสอบสิทธิ์ การแยกวิเคราะห์การตอบกลับ การจัดการข้อผิดพลาด และการจัดการคำสั่งซื้อที่รอดำเนินการ ก่อนเปิดใช้งานการจดทะเบียน การต่ออายุ หรือการโอนย้ายจริง

ได้ ปลายทาง ตรวจสอบความพร้อมของโดเมน รองรับชื่อโดเมนหลายชื่อโดยคั่นด้วยเครื่องหมายจุลภาค

example.com,example.net,example.org

อย่าถือว่าการดำเนินการ API ทุกรายการรองรับรูปแบบอินพุตหลายโดเมนแบบเดียวกัน การจดทะเบียน การต่ออายุ และการโอนย้ายควรปฏิบัติตามเอกสารของแต่ละปลายทาง

ใช้ปลายทาง รับราคาโดเมน ประเภทราคาที่ระบุไว้ในเอกสาร ได้แก่ register, renew, transfer และ all

การตอบกลับการจดทะเบียนอาจมีค่า is_premium เพื่อระบุว่าการจดทะเบียนที่สอบถามเป็นแบบพรีเมียมหรือไม่

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

ไม่ใช่ แม้ว่าเอกสาร API จะรองรับระยะเวลาสูงสุด 1–10 ปีสำหรับนามสกุลที่เกี่ยวข้อง แต่แต่ละ TLD อาจมีกฎเกณฑ์ของรีจิสทรีที่แตกต่างกัน

ระยะเวลาการจดทะเบียน ระยะเวลาการต่ออายุ คุณสมบัติการโอน ข้อกำหนดด้านข้อมูลติดต่อ และข้อกำหนดการตรวจสอบอาจแตกต่างกันไปตามนามสกุล แอปพลิเคชันของคุณควรปฏิบัติตามกฎปัจจุบันของ TLD ที่เกี่ยวข้อง

การดำเนินการเหล่านี้แยกจากกัน และไม่ควรถือว่าใช้แทนกันได้

โปรดใช้รหัสและข้อความที่ส่งกลับมาในการตรวจสอบสถานะของคำขอ API เสมอ

ดูรหัสตอบกลับของ API →

การตอบกลับ 201 หมายความว่าการดำเนินการได้รับการยอมรับสำหรับการประมวลผลแล้ว แต่ยังไม่จำเป็นต้องถึงสถานะสุดท้าย

สำหรับการจดทะเบียนโดเมน การตอบกลับ 201 ระบุว่าได้ส่งคำสั่งซื้อแล้วและกำลังรอการประมวลผลขั้นสุดท้ายจากทะเบียนกลาง

อย่าแจ้งให้ลูกค้าปลายทางทราบว่าโดเมนเปิดใช้งานแล้ว จนกว่าระบบของคุณจะยืนยันผลลัพธ์สุดท้ายได้ ปฏิบัติตามเอกสารของ endpoint การจดทะเบียนสำหรับกฎล่าสุดเกี่ยวกับคำสั่งซื้อที่รอดำเนินการและการจัดการการคืนเงิน

การโอนที่รอดำเนินการหมายความว่าคำขอโอนได้รับการยอมรับสำหรับการประมวลผลแล้ว ไม่ได้หมายความว่าโดเมนได้โอนไปยัง NiceNIC เรียบร้อยแล้ว

ความสำเร็จในการโอนย้ายอาจขึ้นอยู่กับการประมวลผลของ registry และ registrar รวมถึงสถานะการโอนย้ายปัจจุบันของโดเมน ควรคงสถานะการโอนย้ายไว้ในสถานะรอดำเนินการจนกว่าจะได้รับการยืนยันว่าเสร็จสมบูรณ์

ได้ List Domains API รองรับการดึงข้อมูลพอร์ตโฟลิโอพร้อมตัวเลือกการแบ่งหน้า การจัดเรียง และการกรอง

ใช้ Get Domain Details เมื่อคุณต้องการข้อมูลโดยละเอียดสำหรับโดเมนแต่ละรายการ เช่น ข้อมูลการจดทะเบียน ข้อมูลวันหมดอายุ เนมเซิร์ฟเวอร์ และข้อมูลผู้ติดต่อของโดเมน

NiceNIC Domain API v2 รวมถึงการดำเนินการด้านการละเมิดและการปฏิบัติตามข้อกำหนดที่ออกแบบมาสำหรับแพลตฟอร์มและผู้รับจ้างขายที่จัดการพอร์ตโฟลิโอโดเมนของลูกค้า

คุณสามารถระบุโดเมนที่เกี่ยวข้องกับรายงานการละเมิดและดึงข้อมูลการปฏิบัติตามข้อกำหนดที่เครื่องอ่านได้สำหรับโดเมนแต่ละรายการ ทั้งนี้ขึ้นอยู่กับกรณี การตอบกลับอาจรวมถึงสถานะโดเมน ผลกระทบปัจจุบัน การดำเนินการที่แนะนำ ข้อมูลการระงับ ข้อมูลข้อร้องเรียน และ URL ที่ถูกรายงาน

ซึ่งทำให้สามารถแสดงสถานะการปฏิบัติตามข้อกำหนดได้โดยตรงภายในพอร์ทัลลูกค้าหรือระบบปฏิบัติงานของคุณเอง

ใช่ครับ NiceNIC ให้บริการผสานระบบรีจิสตราร์กับ WHMCS สำหรับธุรกิจที่ใช้งาน WHMCS อยู่แล้วสำหรับการเรียกเก็บเงินและการจัดเตรียมบริการ

ใช้ Domain API v2 โดยตรงเมื่อคุณกำลังสร้างแอปพลิเคชันหรือขั้นตอนการทำงานของคุณเอง ใช้การผสาน WHMCS เมื่อคุณต้องการให้การดำเนินการโดเมนผสานเข้ากับสภาพแวดล้อม WHMCS ที่มีอยู่

ดูการผสาน WHMCS →

ภาษาโปรแกรมหรือรันไทม์ฝั่งเซิร์ฟเวอร์ใดก็ได้ที่สามารถส่งคำขอ HTTPS และแยกวิเคราะห์ JSON ได้ก็สามารถผสานกับ Domain API v2 ได้

ตัวเลือกที่พบบ่อยได้แก่ PHP, Python, Node.js และ Java เก็บข้อมูลรับรอง API ไว้ฝั่งเซิร์ฟเวอร์และอย่าเปิดเผย API Secret ของคุณใน JavaScript ฝั่งเบราว์เซอร์หรือโค้ดไคลเอ็นต์ที่ดาวน์โหลดได้

อาจมีการจำกัดอัตราการเรียกใช้เพื่อปกป้องความเสถียรของ API และความปลอดภัยของแพลตฟอร์ม

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

รวมถึงการประทับเวลาของคำขอ หมวดหมู่และการดำเนินการของ API ชื่อโดเมน (ถ้าเกี่ยวข้อง) พารามิเตอร์คำขอที่ไม่เป็นข้อมูลอ่อนไหว รหัสตอบกลับและข้อความตอบกลับที่ส่งกลับมา และว่าคำขอนั้นมาจากสภาพแวดล้อมทดสอบหรือสภาพแวดล้อมจริง

ส่งคำร้อง →

ใช้เมนูนำทาง API ในเอกสารประกอบ การดำเนินการแต่ละรายการมีหน้าเฉพาะสำหรับพารามิเตอร์ที่รองรับ ตัวอย่างคำขอ ตัวอย่างการตอบกลับ และพฤติกรรมเฉพาะของการดำเนินการนั้น

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

เปิดเอกสาร API →