Za programe i AI agente

Domen koji može da kupi i vaš program.

Jedan poziv za cene i dostupnost svih ekstenzija — bez ključa. Jedan poziv za porudžbinu — sa ključem koji vlasnik naloga izda za minut. Domen se registruje direktno kod RNIDS-a, automatski po uplati. JSON, UTF-8, OpenAPI 3.1, Idempotency-Key.

Rezultat poziva GET /v1/pretraga stiže ovde — isti podaci koje dobija program.

Bez ključa: 60 poziva u minuti po adresi; žive provere kod registra dele zajednički budžet (tada stoji „odloženo“ — ponovite za koji minut).

Zahtev
curl "https://domeni.metoda.rs/v1/pretraga?ime=mojafirma"
Bez ključapretraga, cene i dostupnost — za bota koji tek bira registra
.rs · .срб + 50nacionalne direktno kod RNIDS-a, međunarodne preko partnera
Idempotency-Keyponovljen zahtev vraća isti odgovor — nema duple naplate
OpenAPI 3.1opis za generisanje klijenta, kodovi grešaka, X-Zahtev-Id
Kako radi

Tri poziva do aktivnog domena

1

Proverite — bez ključa

Jedan GET vraća .rs, .срб, .co.rs, .org.rs, .in.rs i .com/.net/.org sa cenom i dostupnošću. Slobodan red već nosi gotov zahtev za porudžbinu.

GET /v1/pretraga
# bez ključa — sve ekstenzije, cene i dostupnost
curl "https://domeni.metoda.rs/v1/pretraga?ime=mojafirma"
2

Poručite — sa ključem

Vlasnik naloga izda ključ (Nalog → API pristup, opseg billing:charge). POST vraća porudžbinu, link za karticu i uplatnicu. Podaci kartice ne prolaze kroz API.

POST /v1/domeni/registruj
# sa ključem iz naloga — porudžbina; Idempotency-Key je obavezan
curl -X POST https://domeni.metoda.rs/v1/domeni/registruj \
  -H "Authorization: Bearer mtd_live_…" \
  -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{"domen":"mojafirma.rs","godina":1}'
3

Platite i pratite

Po uplati domen registrujemo sami, direktno kod registra. Stanje se čita dok ne bude „registered“; nejmserveri, brava i kod za prenos su takođe u API-ju.

GET /v1/nalozi/{id}
# stanje porudžbine — dok reg_status ne bude "registered"
curl -H "Authorization: Bearer mtd_live_…" \
  https://domeni.metoda.rs/v1/nalozi/4821
Rute

Šta API ume

Metod i rutaŠta radiPristup
GET/v1/pretraga?ime=mojafirmaSve ekstenzije sa cenama i dostupnošću odjednom; slobodan red nosi gotov zahtev za porudžbinu. bez ključa
GET/v1/cenovnikCene registracije, obnove i prenosa po ekstenziji (RSD, sa PDV-om). bez ključa
GET/v1/domeni/slobodan?domen=x.rsDa li je jedan domen slobodan, sa cenom i izvorom. bez ključa
GET/v1/meNalog i ovlašćenja ključa. ključ
POST/v1/domeni/registrujPoruči registraciju (1–10 godina); vraća link za karticu i uplatnicu. Idempotency-Key obavezan. ključ
POST/v1/domeni/{domen}/obnoviPoruči obnovu. ključ
POST/v1/prenosiPokreni prenos kod nas: {"domen","auth_kod"}. ključ
GET/v1/nalozi, /v1/nalozi/{id}Porudžbine i stanje registracije. ključ
GET/v1/domeni, /v1/domeni/{domen}Domeni na nalogu i jedan domen. ključ
PUT/v1/domeni/{domen}/nejmserveriIzmena nejmservera (2–4); GET vraća trenutne iz registra. ključ
GET/v1/domeni/{domen}/bravaZaštita od prenosa (GET stanje, PUT uključi/isključi); POST …/authkod daje kod za prenos. ključ
GET/v1/prenosi/{domen}Stanje prenosa jednog domena. ključ
GET/v1/dnevnikSopstveni pozivi ka API-ju, sa trajanjem i greškom. ključ
GET/v1/openapi.jsonOpis za programe (OpenAPI 3.1). GET /v1/ vraća spisak ruta i svih kodova grešaka. bez ključa

Spisak svih ruta i kodova grešaka u JSON obliku: GET /v1/. Puni opis: /v1/openapi.json.

Ključ, granice, greške

Jasna pravila za program

Ključ i ovlašćenja

  • Ključ izdaje vlasnik naloga: prijava → API pristup → Izdaj ključ. Pun ključ se vidi jednom; kod nas ostaje samo otisak.
  • Opsezi: domains:read, domains:write, billing:read, billing:charge — dajte agentu samo ono što mu treba.
  • Šalje se kao Authorization: Bearer mtd_live_…; povlači se istim ekranom i prestaje da radi odmah.
  • Domen uvek pripada nalogu vlasnika — tu su i podaci nosioca, EPP kod i obnova.

Granice i sigurnost

  • Sa ključem 120 poziva u minuti; bez ključa 60 u minuti po adresi.
  • Žive provere kod RNIDS-a dele budžet — odgovor tada nosi izvor: "odlozeno", a keš i cene ostaju.
  • Svaka kupovina traži Idempotency-Key: ponovljen zahtev vraća prvi odgovor i ne pravi drugu porudžbinu.
  • Svaki odgovor nosi X-Zahtev-Id — navedite ga kad pišete podršci.

Plaćanje

  • Porudžbina vraća placanje.karticom (Stripe link: kartica, Apple Pay, Google Pay) i placanje.uplatnica (račun, model 97, poziv na broj — IPS QR ili virman).
  • U panelu i PayPal i Bitcoin. Uplatu proveravamo automatski; po uplati domen registrujemo sami.
  • Fiskalni račun stiže na e-adresu iz porudžbine. Neplaćena porudžbina se sama briše posle 7 dana.

Greške koje program razume

Svaka greška je JSON sa stalnim kodom i porukom za čoveka: {"ok":false,"greska":{"kod":"…","poruka":"…"}}

KodHTTPZnačenje
nema_kljuca · kljuc_nepoznat401Ruta traži ključ, a nije poslat ili nije prepoznat.
nema_ovlascenja403Ključ nema traženi opseg (npr. billing:charge).
domen_neispravan400/422Naziv koji registar ne prima (dužina, crtice, mešano pismo).
domen_zauzet409Domen je već registrovan.
idem_obavezan · idem_neslaganje400/409Nema Idempotency-Key, ili je isti ključ poslat sa drugim telom.
previse_poziva429Granica poziva ili budžet živih provera — ponoviti posle Retry-After.
provera_nedostupna503Registar ili partner ne odgovara — ništa nije naplaćeno.
Za AI agente

Dajte agentu ovo uputstvo

Agent prvo pretražuje bez ključa, pa od vas traži ključ samo za kupovinu. Kratak mašinski sažetak sajta je na /llms.txt, opis ruta na /v1/openapi.json.

Agent ne može da potroši više nego što vlasnik plati: API ne drži sredstva, a kartica se unosi kod Stripe-a, ne kroz API.

Uputstvo za agenta (kopirajte)
Registruj domen preko Metode (domeni.metoda.rs). Pročitaj https://domeni.metoda.rs/v1/openapi.json.
1) GET https://domeni.metoda.rs/v1/pretraga?ime=<naziv> (bez ključa) — izaberi slobodan domen i cenu.
2) Zatraži od vlasnika ključ (nalog → API pristup, opseg billing:charge) i pošalji ga kao Authorization: Bearer.
3) POST /v1/domeni/registruj sa zaglavljem Idempotency-Key (UUID) i telom {"domen":"…","godina":1}.
4) Vlasniku prosledi placanje.karticom (link) ili uplatnicu; proveravaj GET /v1/nalozi/{nalog_id} dok reg_status ne bude "registered".
Ne ponavljaj POST bez istog Idempotency-Key. Sve poruke su na srpskom; greške imaju polje greska.kod.

Spremni? Nalog, ključ, prvi poziv — za pet minuta.

Nalog je besplatan i uz njega ide sanduče @metoda.rs. Ključ izdajete u panelu, u delu „API pristup“.

Napravite nalog Prijavite se → API pristup

Pitanja o API-ju: podrska@metoda.rs

Podrška

Tu smo kada vam zatreba

Pitanja o ključu, porudžbini kroz API ili prenosu domena — javite nam se direktno, uz X-Zahtev-Id iz odgovora.

Radno vreme
radnim danima i subotom 09:00–17:00 h