{"ok":true,"servis":"Metoda domeni API","verzija":"v1","uputstvo":"Ključ izdajete na https://domeni.metoda.rs → API pristup. Šaljite ga kao: Authorization: Bearer mtd_live_...","opsezi":["domains:read","domains:write","billing:read","billing:charge"],"rute":{"GET    /v1/ping":"provera veze (bez ključa)","GET    /v1/me":"podaci naloga i ovlašćenja ključa","GET    /v1/pretraga?ime=mojafirma":"sve ekstenzije sa cenama i dostupnošću odjednom (radi i bez ključa)","GET    /v1/cenovnik":"cene registracije/obnove/prenosa po ekstenziji (radi i bez ključa)","GET    /v1/domeni/slobodan?domen=x.rs":"da li je domen slobodan (radi i bez ključa)","GET    /v1/domeni":"domeni na nalogu","GET    /v1/domeni/{domen}":"jedan domen","GET    /v1/domeni/{domen}/nejmserveri":"nejmserveri iz registra","PUT    /v1/domeni/{domen}/nejmserveri":"izmena nejmservera (2-4)","POST   /v1/domeni/registruj":"poruči registraciju; vraća link za plaćanje karticom","POST   /v1/domeni/{domen}/obnovi":"poruči obnovu; vraća link za plaćanje karticom","GET    /v1/nalozi":"porudžbine","GET    /v1/nalozi/{id}":"jedna porudžbina i status registracije","GET    /v1/prenosi":"zahtevi za prenos na nalogu i njihovo stanje","GET    /v1/prenosi/{domen}":"stanje prenosa jednog domena","POST   /v1/prenosi":"pokreni prenos: {\"domen\",\"auth_kod\"}; kad prenos košta, vraća link za plaćanje","*      /v1/transfers":"isto što i /v1/prenosi"},"idempotencija":"Uz svaki POST pošaljite zaglavlje Idempotency-Key — ponovljen zahtev sa istim ključem vraća prvi odgovor i NE pravi drugu porudžbinu.","opis_za_program":"https://domeni.metoda.rs/v1/openapi.json","strana_za_programere":"https://domeni.metoda.rs/api","bez_kljuca":"GET /v1/pretraga, GET /v1/cenovnik i GET /v1/domeni/slobodan rade i bez ključa: 60 poziva u minuti po adresi, a žive provere kod registra dele zajednički budžet. Sa ključem: 120 poziva u minuti i sopstveni budžet. Sve ostalo traži ključ.","greske":[{"kod":"nema_kljuca","http":401,"znacenje":"Nedostaje ili je neispravno zaglavlje Authorization."},{"kod":"kljuc_nepoznat","http":401,"znacenje":"Ključ ne postoji."},{"kod":"kljuc_povucen","http":401,"znacenje":"Ključ je povučen u podešavanjima naloga."},{"kod":"kljuc_istekao","http":401,"znacenje":"Ključu je istekao rok važenja."},{"kod":"nema_ovlascenja","http":403,"znacenje":"Ključ nema traženo ovlašćenje (opseg)."},{"kod":"domen_zasticen","http":403,"znacenje":"Naš sopstveni domen — preko API-ja se samo čita."},{"kod":"nije_vas_domen","http":404,"znacenje":"Domen nije na vašem nalogu ili još nije registrovan."},{"kod":"nalog_nepoznat","http":404,"znacenje":"Porudžbina nije pronađena na vašem nalogu."},{"kod":"nepoznata_ruta","http":404,"znacenje":"Ruta ne postoji — spisak je na GET /v1/."},{"kod":"metod_nije_dozvoljen","http":405,"znacenje":"Ruta postoji, ali ne prima taj HTTP metod (v. zaglavlje Allow)."},{"kod":"domen_zauzet","http":409,"znacenje":"Domen je već registrovan."},{"kod":"idem_neslaganje","http":409,"znacenje":"Isti Idempotency-Key je upotrebljen sa drugačijim telom zahteva."},{"kod":"idem_u_toku","http":409,"znacenje":"Isti zahtev se upravo izvršava — sačekajte pa proverite stanje."},{"kod":"domen_neispravan","http":400,"znacenje":"Ime domena nije ispravno ili ga registar ne prihvata."},{"kod":"idem_obavezan","http":400,"znacenje":"Za poručivanje je obavezno zaglavlje Idempotency-Key."},{"kod":"idem_dug","http":400,"znacenje":"Idempotency-Key duži od 128 znakova."},{"kod":"tld_nepoznat","http":422,"znacenje":"Tu ekstenziju ne prodajemo."},{"kod":"registrant_nepotpun","http":422,"znacenje":"Nedostaju podaci registranta (spisak je u polju „nedostaje\")."},{"kod":"registrant_neispravan","http":422,"znacenje":"Podatak registranta nije ispravan (telefon, e-adresa, JMBG, PIB, matični broj ili nedozvoljeni znaci) — razlog je u poruci."},{"kod":"drzava_nepoznata","http":422,"znacenje":"Država registranta nije prepoznata — šalje se kao dvoslovni ISO 3166-1 kod (RS, BA, DE…)."},{"kod":"nosilac_bez_naloga","http":422,"znacenje":"Nosilac .rs/.срб domena nema nalog na metoda.rs. Nalog otvara na https://www.metoda.rs/registracija/; u registrant.email ide njegova adresa ime@metoda.rs ili rezervna adresa naloga."},{"kod":"nosilac_vise_naloga","http":422,"znacenje":"Rezervnu adresu iz registrant.email ima više naloga — pošaljite adresu ime@metoda.rs nosioca."},{"kod":"samo_pravna_lica","http":422,"znacenje":"Ekstenziju mogu da registruju samo pravna lica."},{"kod":"samo_fizicka_lica","http":422,"znacenje":"Ekstenziju .in.rs RNIDS dodeljuje samo fizičkim licima."},{"kod":"ns_broj","http":422,"znacenje":"Potrebno je 2 do 4 različita ispravna nejmservera."},{"kod":"godina_neispravna","http":422,"znacenje":"Polje „godina\" mora biti ceo broj između 1 i 10."},{"kod":"previse_neplacenih","http":409,"znacenje":"Nalog ima 10 ili više neplaćenih porudžbina."},{"kod":"previse_poziva","http":429,"znacenje":"Prekoračeno ograničenje poziva (v. zaglavlje Retry-After)."},{"kod":"domen_slobodan","http":409,"znacenje":"Domen nije registrovan — nema šta da se prenese; registruje se."},{"kod":"vec_na_nalogu","http":409,"znacenje":"Domen je već na vašem nalogu — za produženje je /domeni/{domen}/obnovi."},{"kod":"prenos_u_toku","http":409,"znacenje":"Za taj domen već postoji otvoren zahtev za prenos."},{"kod":"prenos_nepoznat","http":404,"znacenje":"Za taj domen nema zahteva za prenos na vašem nalogu."},{"kod":"auth_kod_neispravan","http":422,"znacenje":"Auth kod nije ispravnog oblika. Nacionalni domen (.rs, .срб, .co.rs, .org.rs, .in.rs): kod koji izdaje RNIDS, 36 znakova xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (0–9, a–f); ostale ekstenzije: 4–256 znakova, bez razmaka."},{"kod":"profil_nepotpun","http":422,"znacenje":"Registar za prenos traži telefon i adresu vlasnika naloga (spisak je u polju „nedostaje\")."},{"kod":"prenos_nedostupan","http":422,"znacenje":"Prenos te ekstenzije trenutno nije moguć."},{"kod":"previse_prenosa","http":429,"znacenje":"Najviše 30 zahteva za prenos na sat po nalogu."},{"kod":"prenos_drugi_nalog","http":409,"znacenje":"Za taj domen je već otvoren zahtev za prenos sa drugog naloga."},{"kod":"domen_kod_nas","http":409,"znacenje":"Domen je već registrovan preko Metode (na drugom nalogu ili van naloga) — premešta ga podrška, ne prenos."},{"kod":"domen_na_drugom_nalogu","http":409,"znacenje":"Domen je u našoj evidenciji na drugom nalogu, a u registru više nije kod Metode — prenos pokreće podrška."},{"kod":"domen_zakljucan","http":409,"znacenje":"Domen je zaključan kod dosadašnjeg registra ili u samom registru — prenos nije moguć dok se ne otključa."},{"kod":"prenos_u_registru","http":409,"znacenje":"U registru je za taj domen već u toku prenos."},{"kod":"domen_se_brise","http":409,"znacenje":"Domen je u registru u postupku brisanja."},{"kod":"prenos_zauzet","http":409,"znacenje":"Drugi poziv za isti domen se upravo obrađuje — ponovite za nekoliko sekundi."},{"kod":"zona_nepotpuna","http":409,"znacenje":"U našem DNS-u nema zapisa koje domen sada koristi (samo parking ili ništa) — prelazak bi prekinuo sajt ili poštu."},{"kod":"zona_bez_a","http":409,"znacenje":"Domen sada ima sajt, a u našem DNS-u nema A ni AAAA zapisa za @."},{"kod":"zona_bez_mx","http":409,"znacenje":"Domen sada prima poštu, a u našem DNS-u nema MX zapisa."},{"kod":"zona_cloudflare","http":409,"znacenje":"Zapisi su Cloudflare-ove proksi adrese ili Cloudflare-ovo prosleđivanje pošte — van Cloudflare-a ne rade."},{"kod":"zona_se_objavljuje","http":409,"znacenje":"Zapisi se još objavljuju na ns1/ns2.metoda.rs — ponovite za 5 minuta."},{"kod":"zona_provera_nedostupna","http":503,"znacenje":"Provera naše DNS zone trenutno nije moguća — nejmserveri nisu menjani."},{"kod":"kvar","http":500,"znacenje":"Neočekivana greška kod nas — ništa nije naplaćeno."},{"kod":"baza","http":503,"znacenje":"Servis privremeno nije dostupan."},{"kod":"provera_nedostupna","http":503,"znacenje":"Registar ne odgovara na proveru — ne poručujemo bez provere."},{"kod":"registar_nedostupan","http":503,"znacenje":"Registar trenutno ne odgovara."},{"kod":"brava_ne_skida","http":409,"znacenje":"Domen je zaključan zaštitom od prenosa, a registar trenutno ne dozvoljava da je privremeno skinemo — nejmserveri nisu menjani, domen ostaje zaključan."},{"kod":"ns_izmena_u_toku","http":409,"znacenje":"Za taj domen je upravo u toku druga izmena nejmservera — ponovite za minut."},{"kod":"registar_odbio","http":502,"znacenje":"Registar je odbio izmenu (razlog je u poruci, kad ga registar javi)."},{"kod":"predugo","http":504,"znacenje":"Registar predugo ne odgovara — pokušajte ponovo."}],"primer":{"opis":"Ceo tok: pretraga bez ključa, provera, poručivanje, plaćanje, praćenje.","koraci":["curl \"https://domeni.metoda.rs/v1/pretraga?ime=mojafirma\"   # bez ključa: sve ekstenzije, cene, dostupnost","curl -H \"Authorization: Bearer $KLJUC\" \"https://domeni.metoda.rs/v1/domeni/slobodan?domen=mojafirma.rs\"","curl -X POST -H \"Authorization: Bearer $KLJUC\" -H \"Idempotency-Key: $(uuidgen)\" -H \"Content-Type: application/json\" -d '{\"domen\":\"mojafirma.rs\",\"godina\":1,\"registrant\":{\"jmbg\":\"...\",\"adr\":\"...\",\"ptt\":\"11000\",\"grad\":\"Beograd\"}}' https://domeni.metoda.rs/v1/domeni/registruj","# odgovor nosi placanje.karticom — otvoriti taj link i uneti karticu","curl -H \"Authorization: Bearer $KLJUC\" https://domeni.metoda.rs/v1/nalozi/<nalog_id>   # dok reg_status ne bude \"registered\""]},"zahtev_id":"ab5060e0de9b154dfa9f2d8c7efbca58"}