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.
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).
curl "https://domeni.metoda.rs/v1/pretraga?ime=mojafirma"
import requests, uuid API = "https://domeni.metoda.rs/v1" r = requests.get(API + "/pretraga", params={"ime": "mojafirma"}, timeout=30).json() slobodni = [e for e in r["ekstenzije"] if e["slobodan"]] print([(e["domen"], e["cena"]) for e in slobodni]) # porudžbina (ključ iz naloga → API pristup) h = {"Authorization": "Bearer mtd_live_…", "Idempotency-Key": str(uuid.uuid4())} n = requests.post(API + "/domeni/registruj", json={"domen": "mojafirma.rs", "godina": 1}, headers=h, timeout=60).json() print(n["nalog_id"], n["placanje"]["karticom"]) # link za karticu + uplatnica
const API = "https://domeni.metoda.rs/v1"; const r = await fetch(`${API}/pretraga?ime=mojafirma`).then(x => x.json()); const slobodni = r.ekstenzije.filter(e => e.slobodan); console.log(slobodni.map(e => `${e.domen} ${e.cena} ${e.valuta}`)); // porudžbina (ključ iz naloga → API pristup) const n = await fetch(`${API}/domeni/registruj`, { method: "POST", headers: { Authorization: "Bearer mtd_live_…", "Idempotency-Key": crypto.randomUUID(), "Content-Type": "application/json" }, body: JSON.stringify({ domen: "mojafirma.rs", godina: 1 }) }).then(x => x.json()); console.log(n.nalog_id, n.placanje.karticom); // link za karticu + uplatnica
// Primer odgovora (skraćeno) — pokrenite proveru iznad za pravi odgovor
{
"ok": true,
"ime": "mojafirma",
"valuta": "RSD",
"cene": "godišnje, sa PDV-om; obnova po istoj ceni",
"ekstenzije": [
{"domen": "mojafirma.rs", "tld": ".rs", "slobodan": false, "cena": 2400, "obnova": 2400, "valuta": "RSD", "izvor": "kes", "napomena": null},
{"domen": "mojafirma.org.rs", "tld": ".org.rs", "slobodan": true, "cena": 990, "obnova": 990, "valuta": "RSD", "izvor": "kes", "napomena": null,
"uslov": "samo pravna lica", "poruci": {"metod": "POST", "ruta": "/v1/domeni/registruj", "telo": {"domen": "mojafirma.org.rs", "godina": 1}, "kljuc": "obavezan"}},
…
]
}Tri poziva do aktivnog domena
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.
# bez ključa — sve ekstenzije, cene i dostupnost curl "https://domeni.metoda.rs/v1/pretraga?ime=mojafirma"
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.
# 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}'
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.
# stanje porudžbine — dok reg_status ne bude "registered" curl -H "Authorization: Bearer mtd_live_…" \ https://domeni.metoda.rs/v1/nalozi/4821
Šta API ume
Spisak svih ruta i kodova grešaka u JSON obliku: GET /v1/. Puni opis: /v1/openapi.json.
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) iplacanje.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":"…"}}
| Kod | HTTP | Značenje |
|---|---|---|
nema_kljuca · kljuc_nepoznat | 401 | Ruta traži ključ, a nije poslat ili nije prepoznat. |
nema_ovlascenja | 403 | Ključ nema traženi opseg (npr. billing:charge). |
domen_neispravan | 400/422 | Naziv koji registar ne prima (dužina, crtice, mešano pismo). |
domen_zauzet | 409 | Domen je već registrovan. |
idem_obavezan · idem_neslaganje | 400/409 | Nema Idempotency-Key, ili je isti ključ poslat sa drugim telom. |
previse_poziva | 429 | Granica poziva ili budžet živih provera — ponoviti posle Retry-After. |
provera_nedostupna | 503 | Registar ili partner ne odgovara — ništa nije naplaćeno. |
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.
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 pristupPitanja o API-ju: podrska@metoda.rs
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.