Versionet e API-t

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#

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:

// 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.