Documentație API

API-ul InstaDocs permite integrarea programatică cu sistemele tale existente. Disponibil pentru planul Enterprise.

Prezentare generală

API-ul InstaDocs este RESTful și folosește JSON pentru request/response.

Base URL: https://api.instadocs.eu/v1

Autentificare: Bearer Token (JWT)

Autentificare

Obținere token

POST /auth/token
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret"
}

Response:

{
  "access_token": "eyJhbG...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Utilizare token

Include token-ul în header pentru toate request-urile:

Authorization: Bearer eyJhbG...

Endpoints principale

Companii

GET    /companies              # Lista companiilor
GET    /companies/{id}         # Detalii companie
POST   /companies              # Creare companie
PUT    /companies/{id}         # Actualizare companie
DELETE /companies/{id}         # Ștergere companie

DUAE

GET    /duae                   # Lista DUAE-urilor
GET    /duae/{id}              # Detalii DUAE
POST   /duae                   # Creare DUAE
PUT    /duae/{id}              # Actualizare DUAE
GET    /duae/{id}/export/pdf   # Export PDF
GET    /duae/{id}/export/xml   # Export XML

Monitorizare SEAP

GET    /alerts                 # Lista alerte
POST   /alerts                 # Creare alertă
GET    /tenders                # Licitații potrivite
GET    /tenders/{id}           # Detalii licitație

Exemple

Creare DUAE

POST /duae
Authorization: Bearer eyJhbG...
Content-Type: application/json

{
  "company_id": "comp_123",
  "procedure": {
    "contracting_authority": "Primăria București",
    "reference": "PAP/2024/001",
    "title": "Servicii de consultanță",
    "cpv_codes": ["79400000"]
  },
  "auto_fill": true
}

Export XML

GET /duae/duae_456/export/xml
Authorization: Bearer eyJhbG...
Accept: application/xml

Webhooks

Primește notificări în timp real pentru evenimente.

Evenimente disponibile

• duae.created - DUAE nou creat
• duae.exported - DUAE exportat
• alert.match - Licitație nouă potrivită
• certificate.expiring - Certificat expiră în curând

Configurare webhook

POST /webhooks
Authorization: Bearer eyJhbG...

{
  "url": "https://your-server.com/webhook",
  "events": ["duae.created", "alert.match"],
  "secret": "your_webhook_secret"
}

Rate limiting

| Tip | Limită | |-----|--------| | Requests/minut | 100 | | Requests/oră | 1000 | | Export/oră | 50 |

Header-ele de răspuns includ:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Coduri de eroare

| Cod | Descriere | |-----|-----------| | 400 | Request invalid | | 401 | Neautentificat | | 403 | Acces interzis | | 404 | Resursă negăsită | | 429 | Rate limit depășit | | 500 | Eroare server |

SDK-uri

Oferim SDK-uri oficiale pentru:

• JavaScript/Node.js - npm install @instadocs/sdk
• Python - pip install instadocs
• PHP - composer require instadocs/sdk

Suport tehnic

Pentru suport API:

• Email: api-support@instadocs.eu
• Documentație completă: docs.instadocs.eu/api
• Status API: status.instadocs.eu