Tài liệu API tên miền NiceNIC v2 và Bắt đầu nhanh

Kiểm tra tích hợp của bạn trước khi chuyển sang vận hành chính thức

Sử dụng môi trường thử nghiệm API của NiceNIC để kiểm tra tích hợp API tên miền của bạn trước khi chuyển sang vận hành chính thức. Trong môi trường kiểm thử chuyên dụng, hãy kiểm tra xác thực, các yêu cầu API, cách xử lý phản hồi và quy trình vận hành ứng dụng của bạn.

Phù hợp cho các nhà bán lại, nhà cung cấp dịch vụ lưu trữ, nhà phát triển và nền tảng đang chuẩn bị tích hợp API.

Thực hiện lệnh gọi API đầu tiên trong 4 bước

Bắt đầu bằng một yêu cầu chỉ đọc trước khi bật đăng ký, gia hạn hoặc chuyển nhượng trực tiếp. Điều này giúp bạn xác minh cơ chế xác thực, định dạng yêu cầu và cách xử lý phản hồi mà không cần đặt đơn hàng trả phí.

Yêu cầu đầu tiên được khuyến nghị: Kiểm tra tình trạng khả dụng của tên miền

Điểm cuối kiểm tra tình trạng khả dụng hỗ trợ nhiều tên miền trong một yêu cầu bằng cách phân tách các tên miền bằng dấu phẩy.

Chọn quy trình làm việc bạn cần

Tổng quan dưới đây tương ứng với menu điều hướng bên trái. Hãy dùng phần này để xác định quy trình làm việc phù hợp, sau đó mở trang điểm cuối chuyên dụng để xem tham số, ví dụ yêu cầu và ví dụ phản hồi.

Trình tự tích hợp đầu tiên được khuyến nghị

Một hệ thống tích hợp trong môi trường thực tế đáng tin cậy cần xác minh các điều kiện truy cập và mua hàng trước khi bắt đầu gửi đơn hàng thực tế của khách hàng.

Tìm hiểu về các phản hồi thành công, đang chờ và lỗi

Hành vi chờ xử lý đăng ký

Đối với việc đăng ký tên miền, tài liệu hiện tại nêu rằng phản hồi 201 có nghĩa là đơn hàng đã được gửi thành công và phí đã được khấu trừ, nhưng việc kích hoạt cuối cùng vẫn phụ thuộc vào xác nhận của cơ quan đăng ký. Nếu tên miền không thể kích hoạt, phí đăng ký sẽ được hoàn lại vào số dư tài khoản NiceNIC trong vòng 24 giờ.

Hành vi khi chuyển tên miền đang chờ xử lý

Endpoint chuyển tên miền cũng ghi nhận mã 201 là đơn hàng đang chờ xử lý. Do đó, ứng dụng của bạn nên coi yêu cầu chuyển tên miền đang chờ xử lý là đã được chấp nhận để xử lý, chứ không phải là bằng chứng cho thấy quá trình chuyển tên miền đã hoàn tất.

Tra cứu giá trước khi thực hiện các thao tác trả phí

Điểm cuối tra cứu giá của NiceNIC có thể lấy giá đăng ký, gia hạn và chuyển nhượng cho một tên miền. Các giá trị type được ghi nhận là register, renew, transfer và all. Thời gian được ghi nhận là 1 đến 10 năm và có thể có ngoại lệ riêng cho từng TLD.

Phản hồi về giá đăng ký cũng có thể trả về cờ is_premium. Hãy sử dụng điểm cuối tra cứu giá trước khi gửi yêu cầu trả phí nếu ứng dụng của bạn cần biết chi phí hiện tại ở cấp tài khoản.

Hiểu sự khác biệt giữa nameserver, bản ghi DNS và nameserver con

Tự động hóa giám sát danh mục tên miền, không chỉ các đơn hàng tên miền.

API tên miền v2 cũng bao gồm các thao tác đọc hữu ích sau khi đăng ký. Endpoint List Domains hỗ trợ phân trang, sắp xếp, lọc theo trạng thái và lọc theo trạng thái tạm giữ, trong khi Get Domain Details trả về ngày đăng ký, ngày hết hạn, nameserver và thông tin liên hệ của người đăng ký.

Giám sát lạm dụng và tuân thủ

API về lạm dụng và tuân thủ của NiceNIC có thể liệt kê các tên miền có báo cáo lạm dụng và trả về một bản tóm tắt chi tiết mà máy có thể đọc được cho một tên miền cụ thể. Endpoint chi tiết về lạm dụng mô tả sáu cụm từ trạng thái cấp độ tên miền: Normal, Under Review, Pending ClientHold, ClientHold, Closed và ServerHold.

Phản hồi có thể bao gồm tác động hiện tại, hành động tiếp theo được khuyến nghị, trạng thái tạm giữ và mốc thời gian, số lượng khiếu nại, ngày khiếu nại, danh mục, phân loại lạm dụng DNS, trạng thái bằng chứng và các URL được báo cáo nếu có. Điều này cho phép các nền tảng và nhà bán lại hiển thị trạng thái tuân thủ trong hệ thống vận hành của riêng họ thay vì chỉ dựa vào rà soát thủ công.

Chọn mô hình tích hợp phù hợp với hệ thống của bạn

Tài liệu WHMCS hiện tại liệt kê các yêu cầu: WHMCS 7.0 trở lên, PHP 7.0 trở lên có cURL, thông tin xác thực API NiceNIC hợp lệ và hỗ trợ SSL/TLS.

Khi yêu cầu API thất bại

Hãy bắt đầu từ phản hồi trả về và trạng thái cấu hình thay vì thử lại cùng một thao tác trả phí nhiều lần.