API documentation
Domain registrieren
Die Registrierung eines Domainnamens ist der Prozess, einen einzigartigen Namen im Internet für einen bestimmten Zeitraum zu reservieren, in der Regel ein Jahr oder länger
Content-Type
application-json
Kategorie
domain
Aktion
register
Anfrageparameter
| Parametername | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| domain | Zeichenkette (3-60) | Domainname | example.com |
| year | Ganzzahl (4) | Die Registrierungsdauer 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 | Zeichenkette (1-255) | Organisation / Firmenname | XXX Ltd. |
| name | Zeichenkette (1-16) | Name des Domaininhabers | Xiao Ming |
| country | Zeichenkette (1-255) | Ländercode, z. B. CN | CN |
| state | Zeichenkette (1-255) | Provinz / Bundesland | BeiJing |
| city | Zeichenkette (1-255) | Stadtabkürzung | BJ |
| address | Zeichenkette (1-255) | Postanschrift | BeiJing |
| postcode | Ganzzahl (4-10) | Postleitzahl | 100000 |
| phone | "." zur Trennung von Zahlen (30) | +Ländervorwahl.Gebietscode und Telefonnummer | +86.13800000000 |
| fax | "." zur Trennung von Zahlen (30) | +Ländervorwahl.Gebietscode und Faxnummer | +86.13800000000 |
| E-Mail-Adresse | E-Mail-Adresse | [email protected] | |
| contact_source | Zeichenkette (1-255) | Kontaktquelle: Wenn auf „Mitglied“ eingestellt, sind die Kontaktinformationen identisch mit den Mitgliedsinformationen, und andere Kontaktinformationen werden ignoriert. | member |
Antwortparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| domain | Zeichenkette | Domainname |
| created_date | Datum | Domain-Registrierungszeit |
| expired_date | Datum | Domain-Ablaufdatum |
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ückgabewert
0 OK
Erfolgreiche Antwort
{
"code": 0,
"msg" : "success",
"data" : {
"domain":"skwncks.com",
"created_date":"2025-01-21",
"expired_date":"2026-01-21"
}
}
201 Ausstehend
Ausstehend oderder
{
"code": 201,
"msg" : "Pending order, please wait for the order to be processed!"
}
}
Hinweis:code "201" bedeutet, dass die Registrierung erfolgreich eingereicht wurde und die Gebühr abgebucht wurde. Die endgültige Aktivierung der Domain unterliegt noch der Bestätigung durch die Registry. Wenn die Domain nicht aktiviert werden kann, wird die Registrierungsgebühr innerhalb von 24 Stunden auf Ihr Reseller-Kontoguthaben zurückerstattet.
400 Fehlerhafte Anfrage
{
"code": 400,
"msg" : "Request parameter error",
}
