Domain registrieren
Die Domainnamen-Registrierung ist der Prozess, bei dem ein eindeutiger Name im Internet für einen bestimmten Zeitraum reserviert wird, in der Regel ein Jahr oder länger.
Content-Type
application/json
Kategorie
domain
action
register
Anforderungsparameter
| Parametername | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| domain | String (3-60) | Domainname | example.com |
| year | Integer (4) | Der Registrierungszeitraum beträgt 1 bis 10 Jahre, mit einigen Ausnahmen für bestimmte Domains. | 1 |
| dns1 | Server | Primärer Nameserver | ns3.my-ndns.com |
| dns2 | Server | Sekundärer Nameserver | ns4.my-ndns.com |
| organization | String (1-255) | Organisation / Firmenname | XXX Ltd. |
| name | String (1-16) | Registrantenname | Xiao Ming |
| country | String (1-255) | Ländercode, z. B. CN | CN |
| state | String (1-255) | Provinz / Bundesland | BeiJing |
| city | String (1-255) | Stadtkürzel | BJ |
| address | String (1-255) | Postanschrift | BeiJing |
| postcode | Integer (4-10) | Postleitzahl / ZIP-Code | 100000 |
| phone | "." to separate numbers (30) | +Ländervorwahl, Ortsvorwahl und Telefonnummer | +86.13800000000 |
| fax | "." to separate numbers (30) | +Ländervorwahl, Ortsvorwahl und Faxnummer | +86.13800000000 |
| Email address | Email address | [email protected] | |
| contact_source | String (1-255) | Auf „member“ setzen, um Ihr Mitgliedsprofil anstelle der angegebenen Kontaktdaten zu verwenden. | member |
| document_type | String | Erforderlich für HK-Domains. Übliche Werte: PASSNO (Reisepass), OTHIDV (andere individuelle Dokumentnummer), OTHORG (andere Organisationsdokumentnummer). | PASSNO |
| document_number | String (1-40 bytes) | Dokumentnummer, die dem ausgewählten Typ entspricht. Erforderlich für HK-Domains. | E12345678 |
HK domains require both document fields, including when using contact_source=member. Other domains ignore them. For .com.hk, only BR is accepted.
Antwortparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| domain | String | Domainname |
| created_date | Date | Zeitpunkt der Domänenregistrierung |
| expired_date | Date | Ablaufdatum der Domäne |
Anfragebeispiel
{
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"
}
Rückgabeergebnis
0 OK Erfolgreiche Antwort
{
"code": 0,
"msg" : "success",
"data" : {
"domain":"example.com",
"created_date":"2025-01-21",
"expired_date":"2026-01-21"
}
}
201 Ausstehend Ausstehende Bestellung
{
"code": 201,
"msg" : "Pending order, please wait for the order to be processed!"
}
}
Hinweis: Der Code „201“ bedeutet, dass der Registrierungsauftrag erfolgreich übermittelt und die Gebühr abgebucht wurde. Die endgültige Aktivierung der Domain unterliegt noch der Bestätigung durch die Registrierungsstelle. Falls die Domain nicht aktiviert werden kann, wird die Registrierungsgebühr innerhalb von 24 Stunden auf Ihr Kontoguthaben erstattet.
400 Ungültige Anfrage
{
"code": 400,
"msg" : "Request parameter error",
}
