REST/JSON
MDocs — gestiune documente (REST)
Încarci blob-uri, creezi documente, le descarci/listezi. Identitatea apelantului: header X-MMock-Principal.
URL de bază: https://mdocs.evisoft.com
Endpoint-uri
| Metodă | Cale | Scop |
|---|
| POST | /blobs?documentTypeCode= | Upload binar → 201 { id } |
| DELETE | /blobs/{id} | Șterge blob |
| GET | /documents | Listă pentru principal-ul curent (+ filtre type/folderId/searchBy/orderField, paginare) |
| POST | /documents | Creează document { blobId, principal, name, … } → 201 |
| GET/PATCH/DELETE | /documents/{id} | Detalii / actualizare name|number|expiresOn / recycle |
| GET | /documents/{id}/blob | Descarcă exact octeții urcați |
| GET | /document-types/{code} | Info tip de document |
| GET | /principals/{id}/name | Nume principal (din catalogul de identități) |
| GET | /quota | { storageMaximum, storageUsage } |
Date care funcționează (seed)
| Valoare | Înseamnă |
|---|
d0000000-0000-0000-0000-000000000001 | Document seed „Diplomă Ion Creangă” (DiplomaType) |
d0000000-0000-0000-0000-000000000002 | Document seed „Certificat de naștere” (Unknown) |
document-types: Unknown / folder / DiplomaType | Tipuri de document recunoscute |
X-MMock-Principal (default urn:md:idno/idnp:2000000000001) | Owner-ul folosit la GET /documents |
Scenarii & erori (valori „magice")
| Declanșator | Rezultat |
|---|
?documentTypeCode=MMOCK-500 la POST /blobs | HTTP 500 |
blob > 256 KB | HTTP 413 |
upload peste cotă (storageMaximum 1 GiB) | HTTP 507 |
blobId/document/tip/id necunoscut | HTTP 404 / 400 (după caz) |
Header X-MMock-Auth: unauthorized | forbidden | HTTP 401 / 403 |
Note
- Round-trip real: POST /blobs → POST /documents (cu blobId) → GET /documents/{id}/blob întoarce exact octeții.
- Amânate (ciclu 2): sharing, partial upload, /transform.
Linkuri