API documentation
Rekisteröi verkkotunnus
Verkkotunnuksen rekisteröinti tarkoittaa yksilöllisen nimen varaamista Internetissä määräajaksi, yleensä vuodeksi tai pidemmäksi aikaa
Sisältötyyppi
application-json
kategoria
domain
toiminto
register
Pyyntöparametrit
| Parametrin nimi | Tyyppi | Kuvaus | Esimerkki |
|---|---|---|---|
| domain | Merkkijono (3-60) | Verkkotunnus | example.com |
| year | Kokonaisluku (4) | Rekisteröintiaika on 1–10 vuotta, joillakin domaineilla on poikkeuksia. | 1 |
| dns1 | Palvelin | Ensisijainen nimipalvelin | ns3.my-ndns.com |
| dns2 | Palvelin | Toissijainen nimipalvelin | ns4.my-ndns.com |
| organization | Merkkijono (1-255) | Organisaatio / Yrityksen nimi | XXX Ltd. |
| name | Merkkijono (1-16) | Rekisteröijän nimi | Xiao Ming |
| country | Merkkijono (1-255) | Maatunnus, kuten CN | CN |
| state | Merkkijono (1-255) | Lääni / Osavaltio | BeiJing |
| city | Merkkijono (1-255) | Kaupungin lyhenne | BJ |
| address | Merkkijono (1-255) | Postiosoite | BeiJing |
| postcode | Kokonaisluku (4-10) | Postinumero | 100000 |
| phone | Numeroiden erottamiseen käytä "." (30) | +Maakoodin.aluekoodi ja puhelinnumero | +86.13800000000 |
| fax | Numeroiden erottamiseen käytä "." (30) | +Maakoodin.aluekoodi ja faksinumero | +86.13800000000 |
| Sähköpostiosoite | Sähköpostiosoite | [email protected] | |
| contact_source | Merkkijono (1-255) | Ota yhteyttä -lähde, jos asetettu jäseneksi, yhteystiedot ovat samat kuin jäsenen tiedot, ja muut yhteystiedot ohitetaan | member |
Vastausparametrit
| Parametrin nimi | Tyyppi | Kuvaus |
|---|---|---|
| domain | Merkkijono | Verkkotunnus |
| created_date | Päivämäärä | Verkkotunnuksen rekisteröintiaika |
| expired_date | Päivämäärä | Verkkotunnuksen vanhenemispäivä |
Pyynnön esimerkki
{
curl https://api.nicenic.net/v2/?category=domain&action=register&domain={domain}&year={year}&dns1={dns1}&dns2={dns2}&organization={organization}&name={name}&country={country}&state={state}&city={city}&address={address}&postcode={postcode}&phone={phone}&fax={fax}&email={email}&contact_source={contact_source}
-H "Authorization: username:api_secret"
-H "Content-Type: application/json"
}
Palautettu tulos
0 OK
Onnistunut vastaus
{
"code": 0,
"msg" : "success",
"data" : {
"domain":"skwncks.com",
"created_date":"2025-01-21",
"expired_date":"2026-01-21"
}
}
201 Odottaa
Odottaa taider
{
"code": 201,
"msg" : "Pending order, please wait for the order to be processed!"
}
}
Huomautus:koodi "201" tarkoittaa, että rekisteröintitilaus lähetettiin onnistuneesti ja maksu veloitettiin. Lopullinen toimialueen aktivointi edellyttää vielä rekisterin vahvistusta. Jos toimialuetta ei voida aktivoida, rekisteröintimaksu palautetaan jälleenmyyjätilisi saldolle 24 tunnin kuluessa.
400 Virheellinen pyyntö
{
"code": 400,
"msg" : "Request parameter error",
}
