---
title: "Versionimi dhe zhvlerësimi. | pjespjes.com"
description: "API-ja publike për agjentë përdor versionim në URL që integrimi të fiksojë një kontratë të qëndrueshme dhe ta përmirësojë me vetëdije. Sipërfaqja aktuale e q…"
canonical: "https://pjespjes.com/developers/versioning"
image: "https://pjespjes.com/opengraph-image"
---

# Versionimi dhe zhvlerësimi.

// Politika API

API-ja publike për agjentë përdor versionim në URL që integrimi të fiksojë një kontratë të qëndrueshme dhe ta përmirësojë me vetëdije. Sipërfaqja aktuale e qëndrueshme është v1.

## Versionim në URL

Përdor /agent-api/v1 si URL bazë. Fusha të reja jo-prishëse mund t’i shtohen v1; fushat ekzistuese, kuptimet dhe kodet e dokumentuara të gabimeve mbeten të qëndrueshme brenda versionit.

## Ndryshime prishëse

Një ndryshim prishës merr një version të ri në URL, dokument të përditësuar OpenAPI dhe shënim migrimi. Versioni i vjetër mbetet i disponueshëm gjatë periudhës së publikuar të mbështetjes.

## Sinjalet e zhvlerësimit

Kur një version planifikohet për mbyllje, përgjigjet përfshijnë header-at Deprecation dhe Sunset plus një header Link me rel=deprecation. Faqja e politikës dhe metadatat OpenAPI përditësohen në të njëjtën kohë.

## Gjendja aktuale

v1 është versioni aktual i qëndrueshëm dhe nuk ka datë mbylljeje. Nuk ka header Sunset derisa të shpallet një datë reale.

// Header-at e përgjigjes

```
X-API-Version: v1
RateLimit-Limit: 60;w=60
RateLimit-Remaining: 59
RateLimit-Reset: 42

# only when a retirement date is announced
Deprecation: @<unix-seconds>
Sunset: <HTTP-date>
Link: <https://pjespjes.com/developers/versioning>; rel="deprecation"
```

// Burime të lidhura

Dokumenti OpenAPIDirektoria APIKontakto operatorin

```json
[{"@context":"https://schema.org","@type":"Organization","@id":"https://tatbloxe.com/#organization","name":"TAT & BLOXE SH.P.K","legalName":"TAT & BLOXE SH.P.K","alternateName":["TAT & BLOXE","pjespjes.com","pjespjes"],"url":"https://tatbloxe.com","sameAs":["https://tatbloxe.com","https://pjespjes.com","https://github.com/AltinKukaj/HARDWAREEXPERT"],"areaServed":{"@type":"Country","name":"Kosovo"}},{"@context":"https://schema.org","@type":["Organization","LocalBusiness"],"@id":"https://pjespjes.com/#organization","name":"pjespjes.com","alternateName":"pjespjes","url":"https://pjespjes.com","logo":"https://pjespjes.com/brand/pj-mark.png","sameAs":["https://github.com/AltinKukaj/HARDWAREEXPERT","https://tatbloxe.com"],"description":"PC builder për Kosovë me çmime lokale, pjesë të grupuara dhe kontrolle të përputhshmërisë.","parentOrganization":{"@id":"https://tatbloxe.com/#organization"},"publisher":{"@id":"https://tatbloxe.com/#organization"},"areaServed":{"@type":"Country","name":"Kosovo"},"knowsAbout":["PC components","PC building","hardware compatibility","PC parts price comparison","Kosovo computer stores"],"telephone":"+38349808030","email":"contact@pjespjes.com","address":{"@type":"PostalAddress","streetAddress":"De Rada","addressLocality":"Prizren","addressCountry":"XK"},"contactPoint":{"@type":"ContactPoint","telephone":"+38349808030","email":"contact@pjespjes.com","contactType":"customer support","areaServed":"Kosovo","availableLanguage":["sq","en"]}},{"@context":"https://schema.org","@type":"WebSite","name":"pjespjes.com","alternateName":"pjespjes","url":"https://pjespjes.com/","sameAs":["https://github.com/AltinKukaj/HARDWAREEXPERT","https://tatbloxe.com"],"description":"Krahaso çmimet e pjesëve PC, ndërto PC në Kosovë, kontrollo përputhshmërinë. Alternativë PCPartPicker — pa reklama.","inLanguage":"sq-AL","publisher":{"@id":"https://tatbloxe.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://pjespjes.com/parts/cpu?q={search_term_string}"},"query-input":"required name=search_term_string"}},{"@context":"https://schema.org","@type":"Service","@id":"https://pjespjes.com/#service","name":"pjespjes.com PC parts comparison and build planning","serviceType":"PC parts price comparison and compatibility planning","url":"https://pjespjes.com/","description":"Krahaso çmimet e pjesëve PC, ndërto PC në Kosovë, kontrollo përputhshmërinë. Alternativë PCPartPicker — pa reklama.","provider":{"@id":"https://pjespjes.com/#organization"},"areaServed":{"@type":"Country","name":"Kosovo"},"audience":{"@type":"Audience","audienceType":"PC builders and hardware shoppers in Kosovo"},"availableChannel":{"@type":"ServiceChannel","serviceUrl":"https://pjespjes.com/agent-api/v1","serviceType":"Read-only catalog API"}}]
{"@context":"https://schema.org","@type":"TechArticle","headline":"Versionimi dhe zhvlerësimi.","description":"API-ja publike për agjentë përdor versionim në URL që integrimi të fiksojë një kontratë të qëndrueshme dhe ta përmirësojë me vetëdije. Sipërfaqja aktuale e qëndrueshme është v1.","url":"https://pjespjes.com/developers/versioning","isPartOf":{"@type":"WebSite","name":"pjespjes.com","url":"https://pjespjes.com"}}
```