GET /v2/dns
Zwraca listę istniejących domen. Lista zawiera tylko identyfikator i nazwę domeny - rekordy nie są zwracane, trzeba je pobrać osobno (patrz “Szczegóły domeny”).
{
"success": true,
"zones": [
{
"id": "$domain_id",
"name": "$name"
}, { ... }
]
}
/v2/dns/$DOMAIN_ID)GET /v2/dns/$DOMAIN_ID
Zwraca domenę $DOMAIN_ID wraz ze wszystkimi jej rekordami.
{
"success": true,
"zone": {
"id": "$zone_internal_id",
"name": "$name",
"records": [
{
"record_id": "$record_id",
"record_name": "$record_name",
"record_type": "$record_type",
"record_prio": "$record_prio",
"record_ttl": "$record_ttl",
"record_value": "$record_value",
//lub zamiast record_value
"lbr_type": "$lbr_type",
"lbr_ips": "$lbr_ips",
"lbr_port": "$lbr_port",
"lbr_url": "$lbr_url"
}, { ... }
]
}
}
A,AAAA,CAA,CNAME,MX,NS,PTR,SRV,TXTnull dla rekordów bez priorytetu (m.in. automatyczne rekordy NS)spdns_rec (sprawdzanie portu), spdns_url (sprawdzanie URL), pickrandom (wybór losowego serwera), jeśli to pole jest podane wartość pola $record_value jest ignorowanaspdns_recspdns_urlA i AAAA typu load balancera DNS$DOMAIN_ID w ścieżce musi pochodzić z listy (GET /v2/dns) - id zwracane w obiekcie zone nie działa (patrz “Identyfikatory domen i rekordów”)PUT /v2/dns
Dodaje nową domenę.
{
"name": "$name",
"ip_address": "$ip_address"
}
{
"success": true,
"zone": {
"id": "$zone_internal_id",
"name": "$name",
"records": [
{
"record_id": "$record_id",
"record_name": "$record_name",
"record_type": "$record_type",
"record_prio": "$record_prio",
"record_ttl": "$record_ttl",
"record_value": "$record_value"
}, { ... }
]
}
}
A,AAAA,CAA,CNAME,MX,NS,PTR,SRV,TXTnull dla rekordów bez priorytetu (m.in. automatyczne rekordy NS)NS: ns1.beyond.pl i ns2.beyond.pl, oba z $record_ttl = 3600 i $record_prio = nullA o nazwie równej nazwie domenyPUT /v2/dns/$DOMAIN_ID
Dodaje rekord do domeny $DOMAIN_ID.
{
"record_name": "$record_name",
"record_type": "$record_type",
"record_priority": "$record_priority",
"record_ttl": "$record_ttl",
"record_value": "$record_value",
//lub zamiast record_value
"lbr_type": "$lbr_type",
"lbr_ips": "$lbr_ips",
"lbr_port": "$lbr_port",
"lbr_url": "$lbr_url"
}
A,AAAA,CAA,CNAME,MX,NS,PTR,SRV,TXTspdns_rec (sprawdzanie portu), spdns_url (sprawdzanie URL), pickrandom (wybór losowego serwera), jeśli to pole jest podane wartość pola $record_value jest ignorowanaspdns_recspdns_urlPola $lbr_* są dostępne tylko dla $record_type A lub AAAA.
{
"success": true,
"zone": {
"id": "$zone_internal_id",
"name": "$name",
"records": [
{
"record_id": "$record_id",
"record_name": "$record_name",
"record_type": "$record_type",
"record_prio": "$record_prio",
"record_ttl": "$record_ttl",
"record_value": "$record_value",
//lub zamiast record_value
"lbr_type": "$lbr_type",
"lbr_ips": "$lbr_ips",
"lbr_port": "$lbr_port",
"lbr_url": "$lbr_url"
}, { ... }
]
}
}
A,AAAA,CAA,CNAME,MX,NS,PTR,SRV,TXT.null dla rekordów bez priorytetu; w odpowiedziach API nazywa się record_prio, choć w żądaniu parametr to record_priorityspdns_rec (sprawdzanie portu), spdns_url (sprawdzanie URL), pickrandom (wybór losowego serwera), jeśli to pole jest podane wartość pola $record_value jest ignorowanaspdns_recspdns_urlOdpowiedź zawiera wszystkie rekordy domeny, także te utworzone wcześniej (m.in. automatyczne rekordy NS).
record_prio (dla rekordów bez priorytetu - null)PUT /v2/dns/$DOMAIN_ID/record nie służy do edycji - API odrzuca takie żądanie kodem 400POST /v2/dns/$DOMAIN_ID/record
Edycja rekordu $record_id podanego w zawartości żądania.
{
"record_id": "$record_id",
"record_name": "$record_name",
"record_type": "$record_type",
"record_priority": "$record_priority",
"record_ttl": "$record_ttl",
"record_value": "$record_value",
//lub zamiast record_value
"lbr_type": "$lbr_type",
"lbr_ips": "$lbr_ips",
"lbr_port": "$lbr_port",
"lbr_url": "$lbr_url"
}
A,AAAA,CAA,CNAME,MX,NS,PTR,SRV,TXTspdns_rec (sprawdzanie portu), spdns_url (sprawdzanie URL), pickrandom (wybór losowego serwera), jeśli to pole jest podane wartość pola $record_value jest ignorowanaspdns_recspdns_urlA lub AAAA.{
"success": true,
"zone": {
"id": "$zone_internal_id",
"name": "$name",
"records": [
{
"record_id": "$record_id",
"record_name": "$record_name",
"record_type": "$record_type",
"record_prio": "$record_prio",
"record_ttl": "$record_ttl",
"record_value": "$record_value",
//lub zamiast record_value
"lbr_type": "$lbr_type",
"lbr_ips": "$lbr_ips",
"lbr_port": "$lbr_port",
"lbr_url": "$lbr_url"
}, { ... }
]
}
}
A,AAAA,CAA,CNAME,MX,NS,PTR,SRV,TXT.null dla rekordów bez priorytetuspdns_rec (sprawdzanie portu), spdns_url (sprawdzanie URL), pickrandom (wybór losowego serwera), jeśli to pole jest podane wartość pola $record_value jest ignorowanaspdns_recspdns_url$DOMAIN_ID), a edytowany rekord wskazuje pole record_id w zawartości żądaniarecord_id w zawartości żądania jest wymagane - bez niego API zwraca 400DELETE /v2/dns/$DOMAIN_ID/record
Usuwa rekord $record_id podany w zawartości żądania.
{
"record_id": "$record_id"
}
{
"success": true,
"zone": {
"id": "$zone_internal_id",
"name": "$name",
"records": [
{
"record_id": "$record_id",
"record_name": "$record_name",
"record_type": "$record_type",
"record_prio": "$record_prio",
"record_ttl": "$record_ttl",
"record_value": "$record_value"
}, { ... }
]
}
}
A,AAAA,CAA,CNAME,MX,NS,PTR,SRV,TXT.null dla rekordów bez priorytetuOdpowiedź zawiera rekordy pozostałe po usunięciu.
$DOMAIN_ID), a usuwany rekord wskazuje pole record_id w zawartości żądaniarecord_id jest wymaganaDELETE /v2/dns/$DOMAIN_ID
Usuwa domenę $DOMAIN_ID wraz ze wszystkimi jej rekordami.
{
"success":true
}