# Specificații tehnice generale

### Structura cererilor

Toate interacțiunile cu API-ul se realizează prin cereri HTTPS, cu date în format JSON. Răspunsurile sunt de asemenea returnate în format JSON.

#### Baze URL disponibile

| Mediu          | URL bază                           |
| -------------- | ---------------------------------- |
| PROD           | `https://api.maibmerchants.md`     |
| TEST (Sandbox) | `https://sandbox.maibmerchants.md` |

Este recomandat ca testarea inițială să fie realizată în mediu sandbox, înainte de solicitarea accesului în mediu de producție. 

Pentru a trece cu succes testarea integrării API QR MIA, este necesară urmărirea etapelor, care includ obținerea datelor de acces, autentificarea, generarea codurilor QR, gestionarea notificărilor și validarea răspunsurilor API. 

### Autentificare 

Autentificarea se realizează prin intermediul unui token de tip **Bearer**, obținut în prealabil.

Token-ul se transmite în antetul fiecărei cereri:

```
cssCopyEditAuthorization-> Authorization
```

Pentru detalii privind obținerea token-ului, se poate consulta secțiunea[ Autentificare](https://docs.maibmerchants.md/mia-qr-api/overview/broken-reference).

### Formatul datelor

* Format acceptat: `application/json`
* Câmpurile de tip `datetime` trebuie să fie în formatul ISO 8601 (exemplu: `2029-10-22T10:32:28`)
* Moneda utilizată este **MDL** (Leul Moldovenesc)

### Coduri de răspuns HTTP

Pentru lista completă a codurilor de răspuns HTTP accesați secțiunea [Coduri de stare HTTP](https://docs.maibmerchants.md/mia-qr-api/overview/broken-reference).

| Cod | Semnificație                                   |
| --- | ---------------------------------------------- |
| 200 | Cerere validă, răspuns returnat                |
| 400 | Cerere invalidă (eroare de structură sau date) |
| 401 | Neautorizat (token lipsă sau invalid)          |
| 403 | Acces interzis (drepturi insuficiente)         |
| 500 | Eroare internă a serverului                    |