Tổng quan

Dự án này cung cấp các API để tương tác với dịch vụ tên miền của TenTen, bao gồm tìm kiếm, đăng ký, quản lý và gia hạn tên miền. API được thiết kế để dễ dàng tích hợp vào các hệ thống quản lý tên miền hiện có.

Cấu hình

Thiết lập API Credentials

Trong file apitenten.php, bạn cần cấu hình các thông tin sau:

<?php
define("API_KEY", "api key lay tu trang cau hinh");
define("API_USER", "api user lay tu trang cau hinh");  
define("API_URL", "url ket noi api lay tu trang cau hinh");
?>

Class API Core

File apitenten.php chứa class apiTenTen với phương thức callApi() để thực hiện các cuộc gọi API thông qua cURL.

Các API Endpoints

$cmd = "search.json";
$dataRequest["api_key"] = API_KEY;
$dataRequest["api_user"] = API_USER;
$dataRequest["domainName"] = "tenten.vn";

$cmd = "whois.json";
$dataRequest["api_key"] = API_KEY;
$dataRequest["api_user"] = API_USER;
$dataRequest["domainName"] = "tenten.com";

Dữ liệu tham chiếu

Dữ liệu địa danh hành chính

Thư mục dia_danh_hanh_chinh/ chứa các file dữ liệu về địa danh hành chính Việt Nam:

• location_provinces.csv/json: Danh sách tỉnh thành
• location_districts.csv/json: Danh sách quận/huyện
• location_wards.csv/json: Danh sách phường/xã

 Cách sử dụng

1. Cấu hình API: Thiết lập API_KEY, API_USER, và API_URL trong file apitenten.php
2. Include file chính:

   require_once "apitenten.php";

3. Tạo request: Tạo mảng dữ liệu với các parameters cần thiết
4. Gọi API: Sử dụng phương thức $api->callApi($cmd, $request)
5. Xử lý response: Parse JSON response và xử lý kết quả

Ví dụ code mẫu

<?php
require_once "apitenten.php";

// Kiểm tra tên miền
$cmd = "search.json";
$dataRequest = array(
    "api_key" => API_KEY,
    "api_user" => API_USER,
    "domainName" => "example.vn"
);

$result = $api->callApi($cmd, $dataRequest);
$dataResult = json_decode($result, true);

if ($dataResult['status'] == 'success') {
    echo "Tên miền có thể đăng ký";
} else {
    echo "Tên miền đã được đăng ký";
}
?>

Lưu ý quan trọng

Xử lý lỗi

Tất cả các API sẽ trả về response dạng JSON. Cần kiểm tra trường status để xác định kết quả thành công hay thất bại.

$dataResult = json_decode($result, true);

if ($dataResult['status'] == 'success') {
    // Xử lý khi thành công
    echo "Thao tác thành công: " . $dataResult['message'];
} else {
    // Xử lý khi có lỗi
    echo "Lỗi: " . $dataResult['error_message'];
}

Bảo mật