v1.0.0
REST API

API Documentation

API-ul Livraria îți permite să integrezi serviciile noastre de curierat direct în aplicația ta.

Swagger Documentation
API Status: Operational

# Features

API-ul Livraria este o interfață REST care îți permite să:

📦

Gestionare expedieri

Creează, urmărește și gestionează expedierile prin toate serviciile de curierat disponibile.

💰

Comparare prețuri

Compară prețuri în timp real de la diferiți curieri pentru a găsi cea mai bună ofertă.

📊

Tracking în timp real

Urmărește statusul coletelor în timp real și primește actualizări automate.

💳

Plăți și ramburs

Gestionează plățile COD și interogează statusul transferurilor bancare.

# Base URL

https://www.api.livraria.ro/v1
$ curl https://www.api.livraria.ro/v1

# Available Endpoints

POST/auth/loginAuthentication
→
POST/quotesCreate price quotes
→
POST/shipmentsCreate shipments
→
GET/cod-paymentsQuery COD payments
→
GET/remeasurementsQuery remeasurements
→

# Rate Limiting

⚡

API Rate Limits

General Endpoints

  • • 1,000 requests/hour per API key
  • • Rate limit header included in responses
  • • 429 status code when exceeded

Authentication

  • • 10 attempts/minute per IP
  • • Stricter limits for security
  • • Throttling applies to login attempts

Headers returned: X-RateLimit-Remaining, X-RateLimit-Reset

Coduri de eroare

CodDescriere
400Bad Request - Parametrii sunt invalizi
401Unauthorized - API key invalid sau lipsă
429Too Many Requests - Ai depășit limita de cereri
500Internal Server Error - Eroare pe serverele noastre

Ai nevoie de ajutor cu integrarea?

Echipa noastră tehnică te poate ajuta cu implementarea API-ului în aplicația ta.

Contactează echipa tehnică