CheckDomain - Domain Names - Alibaba Cloud Documentation Center

Memeriksa apakah sebuah Nama domain dapat didaftarkan.

Untuk informasi lebih lanjut tentang cara menentukan validitas Nama domain, lihat Domain name validity.

Catatan

Frekuensi pemanggilan operasi CheckDomain dibatasi. Batasnya adalah 10 kueri per detik (QPS) untuk satu pengguna dan total 100 QPS untuk operasi ini.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara otomatis menghasilkan contoh kode operasi untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	CheckDomain	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CheckDomain.
DomainName	String	Yes	test**.xin	Nama domain yang ingin Anda tanyakan.
FeeCommand	String	No	create	Perintah operasi. Nilai yang valid: create: Membeli Nama domain. renew: Memperpanjang Nama domain. transfer: Mentransfer Nama domain ke Alibaba Cloud. restore: Menebus Nama domain.
FeeCurrency	String	No	USD	Jenis mata uang. Nilai yang valid: USD: Dolar Amerika Serikat
FeePeriod	Integer	No	1	Durasi langganan Nama domain. Satuan: Year. Nilai yang valid: 1 hingga 10.
Lang	String	No	en	Bahasa untuk pesan kesalahan yang dikembalikan. Nilai yang valid: zh: Bahasa Tionghoa en: Bahasa Inggris Nilai default: en.

Response parameters

Parameter	Type	Example	Description
Avail	String	1	Menunjukkan apakah Nama domain dapat didaftarkan. Nilai yang valid: 1: Nama domain dapat didaftarkan. 3: Nama domain dapat dipradaftarkan. 4: Prapendaftaran Nama domain dapat dihapus. 0: Nama domain tidak dapat didaftarkan. -1: Nama domain tidak normal. -2: Pendaftaran Nama domain ditangguhkan. -3: Nama domain ditambahkan ke blacklist.
DomainName	String	test**.xin	Nama domain yang ditanyakan.
DynamicCheck	Boolean	true	Menunjukkan apakah harga Nama domain ditentukan oleh nama domain registri. Nilai yang valid: true: Harga nama domain ditentukan oleh registri nama domain. false: Harga Nama domain tidak ditentukan oleh nama domain registri.
Premium	String	true	Menunjukkan apakah Nama domain merupakan Nama domain premium. Nilai yang valid: true: Nama domain merupakan Nama domain premium. false: Nama domain bukan Nama domain premium.
Price	Long	1286	Harga pendaftaran Nama domain premium.
Reason	String	In use	Alasan yang dikembalikan oleh nama domain registri untuk Nama domain yang tidak dapat didaftarkan. Catatan Alasan bervariasi tergantung pada nama domain registri.
RequestId	String	BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1	ID permintaan.

Examples

Contoh permintaan

http(s)://domain.aliyuncs.com/? Action=CheckDomain
&DomainName=test**.xin
&<Common request parameters>

Contoh tanggapan sukses

XML format

<CheckDomain>
      <RequestId>BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1</RequestId>
      <DomainName>test**.xin</DomainName>
      <Avail>1</Avail>
      <DynamicCheck>true</DynamicCheck>
      <Premium>false</Premium>
      <Reason></Reason>
      <Price>1286</Price>
      <StaticPriceInfo>
          <PriceInfo>
              <action>activate</action>
              <money>78</money>
              <period>12</period>
          </PriceInfo>
      </StaticPriceInfo>
</CheckDomain>

JSON format

{
    "RequestId": "BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1",
    "DomainName": "test**.xin",
    "Avail": "1",
    "DynamicCheck": true,
    "Premium": false,
    "Reason": "",
    "Price": 1286,
    "StaticPriceInfo": {
        "PriceInfo": [
            {
              "action": "activate",
              "money": 78,
              "period": 12
            }
        ]
    }
}

Error codes

Untuk daftar kode kesalahan, kunjungi API Error Center.