---
title: "Versionet e API-t"
page_id: "versioning"
section: "Si te fillosh"
canonical: "https://fature.al/api-reference/pages/versioning.html"
---

# Versionet e API-t

Part of the [fature.al API](/api-reference/index.html) documentation.

Ndertoni mbi **`v1`**. Ai mban te gjithe siperfaqen: faturat, e-faturat, arken
fiskale, klientet, produktet, raportet, fletet shoqeruese dhe faturat e blerjes.

`v2` nuk eshte pasardhesi i `v1`. Eshte nje format i ri qe deri tani mbulon vetem
klientet, dhe ekziston krahas `v1`, jo mbi te.

## Cfare mban secili

| Versioni | Endpoint-e | Cfare mbulon |
| --- | --- | --- |
| `v1` | 60 | E gjithe API-ja |
| `v2` | 4 | Vetem klientet, ne formatin e ri |

Numri i vogel i `v2` nuk tregon nje version qe sapo ka nisur te zevendesoje `v1`. Ai
tregon qe `v2` eshte hapur per nje ceshtje te vetme, formen e te dhenave te klientit,
dhe se asgje tjeter nuk eshte prekur.

Nese sistemi juaj leshon fatura, ju duhet `v1`. Nuk ka rruge tjeter: `v2` nuk ka
endpoint fature.

## Kur ia vlen te perdorni v2

`v2` i ndan te dhenat e klientit ne objekte me vete per kompanine, personin, adresen
dhe kontaktin, ne vend te fushave te sheshta te `v1`. Nese sistemi juaj i mban keshtu
tashme, `v2` ju kursen perkthimin ne te dyja drejtimet.

Te dy versionet shkruajne mbi te njejtat te dhena. Nje klient i krijuar me `v1`
lexohet me `v2` dhe anasjelltas, prandaj perdorimi i te dyve njeheresh eshte i
lejueshem: `v2` per klientet dhe `v1` per gjithcka tjeter.

## Nje ndryshim qe duhet ditur

Ne nje deshtim validimi, statusi `422`, te dy versionet kthejne fusha te ndryshme:

```json
// v1
{ "success": false, "message": "...", "errors": { "lines": ["..."] } }

// v2
{ "status": false, "message": "...", "errors": { "company.name": ["..."] } }
```

`v1` perdor `success` vetem ketu. Ne cdo pergjigje tjeter, te suksesshme ose te
gabuar, te dy versionet perdorin `status`. Prandaj lexoni gjithmone me pare kodin HTTP
dhe pastaj fushat e trupit.

## Partner API nuk eshte nje version i trete

`/api/partner/v1` sherben integrimin me Wolt dhe ka nje publik te vetin: nje njesi
e vetme, porosite e saj, pranimi, refuzimi dhe fiskalizimi i tyre. Nuk eshte nje
version i `v1` dhe nuk e zevendeson ate.

Nese nuk po integroni Wolt, ai grup nuk ju perket.

## Asgje nuk eshte ne dalje

Asnje nga versionet nuk ka date perfundimi dhe asnje nuk eshte shpallur i vjeteruar.
Nje integrim i shkruar sot mbi `v1` nuk ka afat qe duhet ndjekur.

Versioni eshte pjese e rruges, pra kerkesa e thote vete cilin do. Nuk ka negocim me
header dhe nuk ka version te nenkuptuar: nje thirrje pa `/v1` ose `/v2` ne rruge nuk
shkon askund.