Documentație API

Dashboard / API Documentation

Înapoi

DNS Panel API v1

Bine ai venit la documentația API DNS Panel. Acest API îți permite să gestionezi programatic zonele și înregistrările DNS.

URL de Bază: {{ $baseUrl }}

🚀 Început Rapid

  1. Creează un token API
  2. Include token-ul în header-ul Authorization
  3. Fă cereri către endpoint-urile API

🔐 Autentificare

Toate cererile API necesită autentificare folosind un token Bearer în header-ul Authorization. 

curl -H "Authorization: Bearer TOKEN_TAU_API" \
     {{ $baseUrl }}/account

⚡ Limite de Rată

Limită Orară
{{ $plan ? number_format($plan->api_rate_limit_hour) : 'Unlimited' }}
Limită Zilnică
{{ $plan ? number_format($plan->api_rate_limit_day) : 'Unlimited' }}

Informațiile despre limitele de rată sunt incluse în header-ele răspunsului: X-RateLimit-Limit-Hour, X-RateLimit-Remaining-Hour

📦 Format Răspuns

Toate răspunsurile sunt în format JSON.

Răspuns Succes:

{
  "success": true,
  "data": { ... }
}

Răspuns Eroare:

{
  "success": false,
  "error": {
    "code": "COD_EROARE",
    "message": "Descriere eroare",
    "details": { ... }
  }
}

📡 Endpoint-uri API

Cont

GET /account

Obține informații cont

GET /account/usage

Obține statistici utilizare API

Zone DNS

GET /zones

Listează toate zonele DNS

Parametri query: search, status, per_page

GET /zones/{'{id}'}

Obține o zonă DNS specifică

POST /zones

Creează o zonă DNS nouă

Exemplu 
curl -X POST {{ $baseUrl }}/zones \
  -H "Authorization: Bearer TOKEN_TAU" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "exemplu.ro",
    "nameserver_id": 1
  }'
PUT /zones/{'{id}'}

Actualizează o zonă DNS

DELETE /zones/{'{id}'}

Șterge o zonă DNS

Înregistrări DNS

GET /zones/{'{id}'}/records

Listează toate înregistrările pentru o zonă

Parametri query: type, search

GET /records/{'{id}'}

Obține o înregistrare DNS specifică

POST /zones/{'{id}'}/records

Creează o înregistrare DNS nouă

Exemplu 
curl -X POST {{ $baseUrl }}/zones/1/records \
  -H "Authorization: Bearer TOKEN_TAU" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "www",
    "type": "A",
    "content": "192.168.1.1",
    "ttl": 3600
  }'
PUT /records/{'{id}'}

Actualizează o înregistrare DNS

DELETE /records/{'{id}'}

Șterge o înregistrare DNS

@if(!$plan || $plan->hasApiFeature('bulk_operations'))
POST /zones/{'{id}'}/records/bulk PRO

Creează înregistrări DNS în masă (până la 100)

Exemplu 
curl -X POST {{ $baseUrl }}/zones/1/records/bulk \
  -H "Authorization: Bearer TOKEN_TAU" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {"name": "www", "type": "A", "content": "192.168.1.1"},
      {"name": "mail", "type": "A", "content": "192.168.1.2"}
    ]
  }'
@endif
@if(!$plan || in_array('statistics:read', $plan->api_endpoints_access ?? []))

Statistici

GET /zones/{'{id}'}/statistics

Obține statistici pentru o zonă

Parametri query: period, days

GET /statistics/summary

Obține statistici sumar pentru toate zonele

@endif

⚠️ Coduri de Eroare

Cod Status HTTP Descriere
UNAUTHORIZED 401 Token API invalid sau lipsă
FORBIDDEN 403 Permisiuni insuficiente
NOT_FOUND 404 Resursă negăsită
VALIDATION_ERROR 422 Date de intrare invalide
RATE_LIMIT_EXCEEDED 429 Prea multe cereri
LIMIT_EXCEEDED 403 Limită plan atinsă

💬 Ai Nevoie de Ajutor?

Dacă ai întrebări sau ai nevoie de asistență cu API-ul, te rugăm să contactezi echipa noastră de suport.

Gestionează Token-uri API