> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Augšupielādēt dokumentu

> Augšupielādēt profilā laboratorijas pārskatu vai jebkuru citu dokumentu un pēc izvēles izgūt tā laboratorijas vērtības

Augšupielādē vienu failu profilā. Nosūti to kā `multipart/form-data`. Bez `extract_results` Aniva tikai
saglabā failu. Ar `extract_results: true` Aniva arī nolasa laboratorijas vērtības no faila.

Tev nav jānorāda, kāda veida pārskats ir failā. To nosaka Aniva. Fails bez laboratorijas rezultātiem, piemēram,
ārsta vēstule, nonāk statusā `stored`, un tā nav kļūda.

Nolasi vērtības ar [Iegūt dokumenta rezultātus](https://docs.anivahealth.com/lv/api/documents/get-document-results.md). Tev nav regulāri
jāveic pieprasījumi: abonē `document.results.*` [webhook paziņojumus](https://docs.anivahealth.com/lv/concepts/webhooks.md).

Nepieciešama `documents_upload` darbības joma kādai no profila grupām. `extract_results: true`
prasa arī `documents_extract_results` darbības jomu tai pašai grupai. Palūdz Aniva tās pievienot.
Dokuments pieder šai grupai: atslēgas ar `results_view` tajā var lasīt dokumentu un tā rezultātus.

Nosūti neobligāto galveni `Idempotency-Key`, lai augšupielādi varētu droši atkārtot. Skati
[Idempotence](https://docs.anivahealth.com/lv/concepts/idempotency.md).

## Ko dara izgūšana

Ar `extract_results: true`:

1. Aniva nosūta failu saviem OCR un MI apakšapstrādātājiem, lai nolasītu vērtības.
2. Vērtības parādās dalībnieka Aniva lietotnē tāpat kā visi citi rezultāti.
3. Katrai vērtībai ir `origin: partner_upload` un tāds pats `status` kā jebkuram citam rezultātam. Vērtībai,
   par kuru Aniva automātiskā pārbaude šaubās, ir statuss `likely_wrong`.

Bez tā fails netiek sūtīts nevienam ārējam pakalpojumam, ja nosūti arī `document_date`.

> [accordion] Precizitāte un datu aizsardzība
>
> * Automātiskā nolasīšana var kļūdaini nolasīt vērtību, mērvienību vai datumu. Oriģinālais fails
>   paliek primārais avots. Salīdzini vērtību ar to, pirms izmanto to medicīniskam lēmumam.
>   Izgūtās vērtības nav diagnoze.
> * Apakšapstrādātāji ir Mistral AI (OCR, ES) un Google Cloud Vertex AI, kam piekļūst caur
>   Vercel AI Gateway (datu izgūšana, var apstrādāt ārpus ES). Tie apstrādā failu tikai tā
>   nolasīšanai.
> * Lai augšupielādētu dalībnieka veselības datus, tev vajadzīgs juridisks pamats, parasti dalībnieka
>   skaidri pausta piekrišana. Tu par to atbildi.

## Pieprasījums

### Veidlapas lauki

**file** `file` *required*

Fails. PDF, DOC, DOCX, PNG vai JPEG, ne vairāk kā 4 MB.

**profile\_id** `string` *required*

Tā profila UUID, kuram pieder dokuments.

**extract\_results** `boolean` (default: false)

`true`, lai nolasītu laboratorijas vērtības no faila. Nosūti `true` vai `false`.

**document\_date** `string`

Parauga datums `YYYY-MM-DD` formātā, ja to zini. Bez tā Aniva nolasa datumu no
faila.

## Atbilde

API atgriež `201 Created`, kad tas tikai saglabāja failu, un `202 Accepted`, kad notiek datu izgūšana.

**id** `string` *required*

Dokumenta ID (UUID). Izmanto to ar [Iegūt dokumenta rezultātus](https://docs.anivahealth.com/lv/api/documents/get-document-results.md) un
[Lejupielādēt dokumentu](https://docs.anivahealth.com/lv/api/documents/download-document.md).

**status** `string` *required*

`processing`, kamēr Aniva izgūst vērtības, vai `stored`, kad fails ir tikai saglabāts.

**profile\_id** `string` *required*

Profils, kuram pieder dokuments.

**document\_date** `string`

Parauga datums, ko nosūtīji, vai tas, ko Aniva nolasīja no saglabātā faila. Var būt `null`.

**results\_url** `string` *required*

Šī dokumenta [Iegūt dokumenta rezultātus](https://docs.anivahealth.com/lv/api/documents/get-document-results.md) URL.

**file\_name** `string` *required*

Attēlojamais faila nosaukums — tas pats, ko nosūta [Lejupielādēt dokumentu](https://docs.anivahealth.com/lv/api/documents/download-document.md).

**original\_file\_name** `string` *required*

Faila nosaukums, ko augšupielādēji.

**origin** `string` *required*

Vienmēr `partner_upload`.

**content\_type** `string` *required*

Faila mediju tips, piem., `application/pdf`.

**etag** `string`

Faila satura versija. Var būt `null`.

**size\_bytes** `integer`

Faila izmērs baitos. Var būt `null`.

**lab\_code** `string`

Augšupielādētam dokumentam vienmēr `null`.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Veidlapas lauks nav derīgs, vai pieprasījuma saturs nav `multipart/form-data`. |
| `403` | Tavai API atslēgai trūkst tiesību tvēruma, profils ir ārpus tava piekļuves konteksta vai nosūtīji `extract_results: true` bez `documents_extract_results`. |
| `404` | Profils nav atrasts. |
| `409` | `duplicate_document`: tas pats fails jau ir šajā profilā. `document_id` to norāda vai ir `null`, ja nevari to nolasīt. Tiek nosūtīts arī `Idempotency-Key` konflikta gadījumā. |
| `413` | `file_too_large`: fails pārsniedz 4 MB. |
| `415` | `unsupported_media_type`: fails nav PDF, DOC, DOCX, PNG vai JPEG. Faila nosaukumam jābeidzas ar `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` vai `.jpeg`. |
| `500` | Iekšēja servera kļūda. `extraction_not_started`: fails ir saglabāts ar `document_id`, bet datu izgūšanu nevarēja sākt. Sazinies ar Aniva. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/documents \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Idempotency-Key: 5f0c2d9e-3b7a-4c1e-9f62-1d8a4e7b0c55' \
  --form 'file=@lab-report.pdf' \
  --form 'profile_id=b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e' \
  --form 'extract_results=true'
```

```json 202 theme={null}
{
  "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
  "status": "processing",
  "profile_id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
  "document_date": null,
  "results_url": "https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results",
  "file_name": "20261023 - lab-report.pdf",
  "original_file_name": "lab-report.pdf",
  "origin": "partner_upload",
  "content_type": "application/pdf",
  "etag": "56104b36f860cfd5b41efc716fdf7b6f",
  "size_bytes": 312480,
  "lab_code": null
}
```

```json 409 theme={null}
{
  "error": "duplicate_document",
  "message": "This file is already on this profile",
  "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.