Hỗ trợ trực tuyến
x
Kinh doanh HN
Kinh doanh HCM
Sale HN1 Sale HN2
Sale HN3 Sale HN4
Sale HCM1 Sale HCM2
Sale HCM3 Sale HCM4
Hotline: 39 42 68 96 / 0919 6868 93 Hotline: 08 - 629 44 808 / 22 00 39 30
Hỗ trợ khách hàng
Support HN
Support HN		 Support HCM
Support HCM
Hotline: 09163 999 77 / 043 942 6896 Hotline: 08-62 84 30 60 / 090 99 66 201

Tổng quan

Nguyên tắc hoạt động

Hệ thống yêu cầu bạn là đại lý của ESC, có username và password đại lý, ngoài ra bạn cần có mã bí mật do bên esc cấp. Khi cài đặt thành công bạn có thể thực hiện các công việc liên quan đến domain do mình quản lý.

Yêu cầu hệ thống

Tài liệu tham khảo

  • PHP Website
  • Apache web server Website
  • MySQL Server Website

Yêu cầu hệ thống

  • Linux hoặc Windows OS
  • PHP v5.1.6+(with MySQL extension)
  • MySQL v4.1.13+ hoặc v5.0.7+
  • NuSOAP v0.9.5+
  • PHP Extensions: OpenSSL phải được kích hoạt

Cài đặt

1 Tải về

- Tải thư viện NuSOAP: Truy cập vào địa chỉ NuSOAP
Hoặc tham khảo tài liệu sử dụng tại www.scottnichol.com/soap/index.html
- Tải thư viện escAPI escAPI
2 Thêm mã code vào chương trình của bạn

+ Thông tin chạy chính thức: Đang cập nhật

Chú ý! Để kết nối với API-ESC. Vui lòng liên hệ để nhận mã code. Để hiểu rõ hơn từng Function của API-ESC hãy xem những phần tiếp theo hoặc có thể trải nghiệm chương trình Demo API-ESC tại mục Download.

Bảng mã lỗi

Kết quả trả về là một mảng có chưa thông tin ứng với mỗi hàm API-ESC, nhưng sẽ luôn có hai giá trị là [code] và [msg]
                        Array
                        (
                            data['code'] => 1000   /* mã lỗi */
                        )
# Mã lỗi Chú thích
1 1000 Câu lệnh xử lý thành công.
2 1001 Câu lệnh xử lý thành công, hành động chờ.
3 1300 Câu lệnh xử lý thành công, không có messages.
4 1301 Câu lệnh xử lý thành công, thực hiện xóa message.
5 1500 Câu lệnh xử lý thành công, kết thúc session.
6 2000 Lỗi lệnh không được định nghĩa.
7 2001 Lỗi cú pháp lệnh.
8 2002 Người sử dụng chưa Login trước khi thực hiện lệnh khác.
9 2003 Các trường thông số bắt buộc bị thiếu.
10 2004 Parameter value range error.
11 2005 Trường thông tin {Tham số} không đúng định dạng.
12 2100 Phiên bản giao thức EPP không được thực hiện.
13 2101 Lệnh không thực hiện.
14 2102 Lựa chọn không được thực hiện.
15 2103 Mở rộng không được thực hiện.
16 2104 Lỗi thanh toán.
17 2105 Khi đối tượng đang PendingTransfer không được thực hiện Renew.
18 2106 Khi đối tượng đang Hold không được thực hiện Transfer.
19 2200 Thông tin xác thực sai dưới N lần trong X phút.
20 2202 Cung cấp mã xác thực sai cho đối tượng Domain, Contact.
21 2300 {Đối tượng} đang chờ chuyển đổi.
22 2301 Khi đối tượng không đang ở trong trạng thái chờ chuyển đổi.
23 2304 Trạng thái {Đối tượng} cấm hoạt động.
24 2305 {Đối tượng} kết hợp đang cấm hoạt động.
25 2307 Đuôi tên miền không được cung cấp bởi VNNIC.
26 2400 Lỗi hệ thống .
27 2500 Lỗi hệ thống, ngắt kết nối.
28 2501 Số lần sai mã xác thực quá N lần trong X phút.
29 2502 Số Session của một Account tại một thời điểm không vượt quá số lượng cho phép.
30 3000 Lỗi chưa xác định.
31 3001 Điều kiện xác thực chưa chính xác.
32 10001 Câu lệnh xử lý thành công, tên miền chưa từ khóa nhạy cảm.
33 10002 Câu lệnh xử lý thành công, tên miền giữ chỗ.
34 10003 Câu lệnh xử lý thành công, không có thông tin.
35 10004 Câu lệnh xử lý thành công, không thuộc nhà đăng ký.
36 20041 Quốc gia không quá 2 ký tự.
37 20051 Trường thông tin {Tham số} nhập phải từ 3- 16 ký tự.
38 20052 Trường Domain không đúng định dạng.
39 20053 Trường thông tin {Tham số} không được có giá trị đặc biệt .
40 20054 Trường thông tin {Tham số} không phải là chữ.
41 20055 Trường thông tin {Tham số} phải là DNS.
42 20056 Trường thông tin {Tham số} phải là IP.
43 20057 Trường thông tin {Tham số} không phải là ký tự số.
44 20058 Không đúng định dạng số điện thoại.
45 20059 Không đúng định dạng Email.
46 22011 Tài khoản đăng nhập đang bị khóa hoặc khóa chỉ cho duy trì.
47 22012 {Đối tượng} không thuộc quyền quản lý của NĐK.
48 23021 {Đối tượng} đã tồn tại trong hệ thống.
49 23022 Tên miền đang được giữ chỗg.
50 23031 Giá trị MessageID không đúng.
51 23032 Tên miền đang có yêu cầu chuyển đổi NĐK.
52 23033 Tên miền đang bị tạm ngưng.
53 23034 {Đối tượng} không tồn tại trong hệ thống.
54 23061 add và rem {đối tượng} trùng nhau.
55 23062 Số năm duy trì không nằm trong phạm vi cho phép.
56 23081 Contact cho quản lý tên miền, quản lý kỹ thuật phải là cá nhân.
57 23082 Số lượng máy chủ trong phạm vi 1<=n<=N.
58 23083 Tên miền quá ngày hết hạn 30 ngày.
59 200510 Không đúng định dạng ngày tháng.

Tạo Contact

- Thông tin liên hệ
1 Các giá trị gửi và nhận
Tên hàm : registercontactind, registercontactorg
Giá trị Giải thích Bắt buộc
Các giá trị gửi
Đối với cá nhân
id_contact * Tham chiếu phần định dạng thông tin tại bảng các thuộc tính của contact.
name * Tên chủ sở hữu Contact
org * Tên tổ chức Cty
address1 * Địa chỉ
address2 * Địa chỉ
address3 * Địa chỉ website
city * Thành phố
province * Tỉnh thành
country * Quốc gia
telephone * Điện thoại
fax * Số Fax
email * Email
birthdate * Ngày sinh
gender * Giới tính
passport * Chứng minh nhân dân
position * Chức vụ
passwd * Mật khẩu
Đối với tổ chức
id_contact * Tham chiếu phần định dạng thông tin tại bảng các thuộc tính của contact.
name * Tên chủ sở hữu Contact
org * Tên tổ chức Cty
address1 * Địa chỉ
address2 * Địa chỉ
address3 * Địa chỉ website
city * Thành phố
province * Tỉnh thành
country * Quốc gia
telephone * Điện thoại
fax * Số Fax
email * Email
passwd * Mật khẩu
inttraname * Tên giao dịch quốc tế
Các giá trị nhận
code Mã kết quả trả về. (Xem thêm ở mục bảng mã lỗi)
Chú ý! Nếu thao tác không thành công thì các giá trị có dấu * sẽ không được trả về
2 Code Demo
- Kết quả trả về

Chú ý! + Hàm 'registercontactind' tạo contact cá nhân.
+ Hàm 'registercontactorg' tạo contact tổ chức. 
                    Array
                    (
                        data['code'] => 1000
                    )

Update Contact

- Cập nhật lại thông tin khách hàng
1 Các giá trị gửi và nhận
Tên hàm : modifycontactind, modifycontactorg
Giá trị Giải thích Bắt buộc
Các giá trị gửi
Đối với cá nhân
id_contact * Tham chiếu phần định dạng thông tin tại bảng các thuộc tính của contact.
name * Tên chủ sở hữu Contact
org * Tên tổ chức Cty
address1 * Địa chỉ
address2 * Địa chỉ
address3 * Địa chỉ
city * Thành phố
province * Tỉnh thành
country * Quốc gia
telephone * Điện thoại
fax * Số Fax
email * Email
birthdate * Ngày sinh
gender * Giới tính
passport * Chứng minh nhân dân
position * Chức vụ
password * Mật khẩu
Đối với tổ chức
id_contact * Tham chiếu phần định dạng thông tin tại bảng các thuộc tính của contact.
name * Tên chủ sở hữu Contact
org * Tên tổ chức Cty
address1 * Địa chỉ
address2 * Địa chỉ
address3 * Địa chỉ
city * Thành phố
province * Tỉnh thành
country * Quốc gia
telephone * Điện thoại
fax * Số Fax
email * Email
password * Mật khẩu
inttraname * Tên giao dịch quốc tế
Các giá trị nhận
code Mã kết quả trả về. (Xem thêm ở mục bảng mã lỗi)
2 Code Demo
- Kết quả trả về
                    Array
                    (
                        [code] => 1000
                    )

Check Domain

- Kiểm tra Domain
1 Các giá trị gửi và nhận
Tên hàm : checkdomain
Giá trị Giải thích Bắt buộc
Các giá trị gửi
Tên miền Tên miền bao gồm cả phần đuôi mở rộng (VD: esc.vn,...)
Các giá trị nhận
0 Tên miền chưa đăng ký
1 Tên miền đã được đăng ký
2 Code Demo

Create Domain

- Đăng ký tài khoản Domain
1 Các giá trị gửi và nhận
Tên hàm : domaincreate
Giá trị Giải thích Bắt buộc
Các giá trị gửi
domain_name Tên domain
passwd Mật khẩu Domain
period Năm duy trì
dns1 DNS1 của Domain
ip1 IP1 của Domain
dns2 DNS2 của Domain
ip2 IP2 của Domain
id_registrant ID chủ sở hữu Domain
id_admin ID quản trị Domain
id_tech ID kỹ thuật Domain
id_billing ID thanh toán Domain
Các giá trị nhận
code Mã kết quả trả về. (Xem thêm ở mục bảng mã lỗi)
2 Code Demo
- Kết quả trả về
                    Array
                    (
                        [code] => 1000
                    )

Domain Info

- Thông tin Domain.
1 Các giá trị gửi và nhận
Tên hàm : domaininfo
Giá trị Giải thích Bắt buộc
Các giá trị gửi
domain_name Tên Domain
Các giá trị nhận
code Mã kết quả trả về. (Xem thêm ở mục bảng mã lỗi)
msg Thông báo kết quả
domain_name * Tên Domain
domain_year * Năm gia hạn
domain_dns1* DNS1
domain_dns2* DNS2
Chú ý! Nếu thao tác không thành công thì các giá trị có dấu * sẻ không được trả về.
2 Code Demo
- Kết quả trả về
                    Array
                    (
                        [code] => 1000
                        [msg] => Thực hiện thành công
                        [domain_name] => esc.vn
                        [domain_year] => 10
                        [domain_dns1] => .....
                        [domain_dns2] => .....
                    )

Update Domain

- Cập nhật thông tin Domain.
1 Các giá trị gửi và nhận
Tên hàm : updatedns
Giá trị Giải thích Bắt buộc
Các giá trị gửi
domain_name Tên Domain
domain_password Mật khẩu Domain
domain_dns1 DNS Domain
domain_dns2 DNS Domain
Các giá trị nhận
code Mã kết quả trả về. (Xem thêm ở mục bảng mã lỗi)
msg Thông báo kết quả
2 Code Demo
- Kết quả trả về
                    Array
                    (
                        [code] => 1000
                        [msg] => Thực hiện thành công
                    )

Renew Domain

- Gia hạn Domain.
1 Các giá trị gửi và nhận
Tên hàm : renewdoamin
Giá trị Giải thích Bắt buộc
Các giá trị gửi
domain_name Tên Domain
domain_year Số năm gia hạn
curexpdate Ngày hết hạn hiện tại
Các giá trị nhận
code Mã kết quả trả về. (Xem thêm ở mục bảng mã lỗi)
msg Thông báo kết quả
2 Code Demo
- Kết quả trả về
                    Array
                    (
                        [code] => 1000
                        [msg] => Thực hiện thành công
                    )

Transfer Domain