Documentație API

Integrează date administrative oficiale pentru România în aplicația ta. Județe, localități, coduri poștale și coordonate GPS.

Obține API Key Vezi Endpoints

1. Creează cont

Înregistrează-te gratuit și adaugă site-ul tău în dashboard.

2. Copiază token

Primești automat un API token unic pentru domeniul tău.

3. Integrează

Trimite token-ul în header și accesează toate datele.

Autentificare

Toate request-urile către API necesită un token valid. Token-ul este legat de domeniul înregistrat și validează automat că request-ul vine de pe site-ul corect.

Header necesar

X-Site-Token: YOUR_API_TOKEN

Wildcard Domains

Înregistrează *.domeniu.ro pentru a permite toate subdomeniile automat.

Domeniu înregistrat	Domenii acceptate
`example.com`	example.com, www.example.com, sub.example.com
`*.example.com`	Orice subdomeniu + domeniul principal
`localhost`	localhost, localhost:3000, localhost:8080

Endpoints

Base URL https://api.siruta.ro/v1

Județe

GET /counties Lista județelor

Returnează toate cele 42 de județe din România, inclusiv coduri SIRUTA și regiuni.

Vezi exemplu răspuns

{
  "data": [
    {
      "id": 1,
      "siruta_code": 10,
      "name": "Alba",
      "abbr": "AB",
      "region": { "id": 7, "label": "Centru" }
    }
  ],
  "meta": { "total": 42 }
}

GET /counties/{abbr} Detalii județ

Returnează informații detaliate despre un județ specific.

Param: abbr - Abrevierea județului (MS, CJ, B)

Localități

GET /counties/{abbr}/localities

Toate localitățile dintr-un județ cu coordonate GPS și relații părinte.

Vezi exemplu răspuns

{
  "data": [{
    "siruta_code": 114337,
    "name": "Mureșeni",
    "type_label": "Componentă municipiu",
    "postal_code": "540001",
    "lat": 46.522996,
    "lng": 24.520033,
    "parent": {
      "name": "Târgu Mureș",
      "type_label": "Municipiu reședință"
    }
  }]
}

GET /localities/lite

Versiune simplificată - ideal pentru dropdown-uri

GET /localities/grouped

Grupate după tip (municipii, orașe, comune)

GET /localities

Căutare globală cu filtre (search, county, type)

GET /localities/{siruta}

Detalii localitate după cod SIRUTA

Metadata

GET /lookups/locality-types

Tipuri de localități (municipiu, oraș, sat...)

GET /lookups/regions

Regiuni de dezvoltare din România

Coduri de eroare

401

Token lipsă sau invalid

Adaugă header-ul X-Site-Token cu un token valid.

403

Domain mismatch

Request-ul vine de pe un domeniu diferit de cel înregistrat.

429

Too Many Requests

Ai depășit limita de 120 request-uri/minut. Așteaptă 1 minut.

Exemple de cod

const response = await fetch('https://api.siruta.ro/v1/counties', {
  headers: {
    'X-Site-Token': 'YOUR_API_TOKEN',
    'Accept': 'application/json'
  }
});

const data = await response.json();

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'X-Site-Token' => 'YOUR_API_TOKEN',
])->get('https://api.siruta.ro/v1/counties');

$counties = $response->json('data');

import requests

headers = {
    'X-Site-Token': 'YOUR_API_TOKEN',
    'Accept': 'application/json'
}

response = requests.get('https://api.siruta.ro/v1/counties', headers=headers)
data = response.json()

curl -X GET "https://api.siruta.ro/v1/counties" \
     -H "X-Site-Token: YOUR_API_TOKEN" \
     -H "Accept: application/json"

Rate Limiting

120

requests

minut

Dacă depășești limita, primești 429 Too Many Requests. Implementează caching local pentru date statice (județe, tipuri).

Gata să integrezi?

Creează un cont gratuit și obține token-ul API în mai puțin de 1 minut. Fără card, fără limite ascunse.

Creează cont gratuit Vezi exemple live