---
title: "Portali i zhvilluesve të pjespjes.com — API, OpenAPI, MCP dhe CLI"
description: "Përdor të njëjtin katalog kosovar të PC-së që fuqizon faqen përmes ndërfaqeve të qëndrueshme JSON, OpenAPI, MCP, Markdown dhe CLI. Fillo me sandbox-in falas…"
canonical: "https://pjespjes.com/docs"
image: "https://pjespjes.com/opengraph-image"
---

# Portali i zhvilluesve të pjespjes.com — API, OpenAPI, MCP dhe CLI

// Portali për zhvillues

Përdor të njëjtin katalog kosovar të PC-së që fuqizon faqen përmes ndërfaqeve të qëndrueshme JSON, OpenAPI, MCP, Markdown dhe CLI. Fillo me sandbox-in falas vetëm për lexim dhe kërko limite më të larta kur integrimi yt të jetë gati.

> Sandbox

GET /agent-api/v1/search_

Endpoint-i anonim i kërkimit është sandbox-i i sigurt për prodhim: nuk ndryshon të dhënat e katalogut, ndërtimet ose llogaritë e dyqaneve. Kthen gabime të strukturuara dhe header-a RateLimit që integrimi të provojë riprovimin para se të kërkojë kredenciale.

// Kredencialet

## Fillo pa çelës.

API-ja publike për agjentë dhe sandbox-i mbështesin thirrje anonime vetëm për lexim. Për limite më të larta, kërko çelës bearer të lëshuar nga operatori ose çift kredencialesh OAuth 2.0 përmes kontaktit. Kredencialet nuk kthehen kurrë në URL ose faqe.

Kërko kredenciale

// Quickstart

## Një kërkesë deri te një rezultat me citim.

Kërko me gjuhë natyrore, rendit sipas çmimit kur duhet dhe përdor URL-në kanonike të kthyer për citime. Çmimet dhe stoku janë fotografi të katalogut; verifiko dyqanin para blerjes.

```
curl "https://pjespjes.com/agent-api/v1/search?q=ryzen%205%207600%20in%20Kosovo&sort=price_asc"
```

// OAuth 2.0

## Autentikim makinë-me-makinë.

Serveri i autorizimit mbështet grant-in client-credentials për scope-in catalog.read. Zbulo fillimisht metadatat, pastaj këmbe një client id dhe secret të provisionuar për token Bearer me jetë të shkurtër.

Metadatat e serverit të autorizimit OAuth

```
curl -u "$OAUTH_CLIENT_ID:$OAUTH_CLIENT_SECRET" \
  -X POST "https://pjespjes.com/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data "grant_type=client_credentials&scope=catalog.read"
```

// Sandbox

## Testo në një sipërfaqe vetëm për lexim.

Endpoint-i anonim i kërkimit është sandbox-i i sigurt për prodhim: nuk ndryshon të dhënat e katalogut, ndërtimet ose llogaritë e dyqaneve. Kthen gabime të strukturuara dhe header-a RateLimit që integrimi të provojë riprovimin para se të kërkojë kredenciale.

Provo kërkimin sandbox

// Instalo CLI-n

npm install -g @pjespjes/cli

API-ja publike është vetëm për lexim. Nuk vendos porosi, nuk proceson pagesa dhe nuk garanton stokun e dyqaneve.

// Burime të lexueshme nga makineritë

## Gjithçka që i duhet një agjenti për t’u lidhur.

Direktoria APIKontrata OpenAPIUdhëzuesi i autentikimitMetadatat e serverit të autorizimit OAuthMCP përmes HTTP StreamableKarta e serverit MCPCLI zyrtar npmJavaScript SDK sourcePython SDK sourceAgent SkillsARD catalogAPI catalogSandboxBatch APIAgent plugin manifestAgent rulesRepositoryllms.txtPolitika e versionimit dhe zhvlerësimitKontakto operatorinGjithçka që i duhet një agjenti për t’u lidhur. — /agents

```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":"Portali i zhvilluesve të pjespjes.com — API, OpenAPI, MCP dhe CLI","description":"Përdor të njëjtin katalog kosovar të PC-së që fuqizon faqen përmes ndërfaqeve të qëndrueshme JSON, OpenAPI, MCP, Markdown dhe CLI. Fillo me sandbox-in falas vetëm për lexim dhe kërko limite më të larta kur integrimi yt të jetë gati.","url":"https://pjespjes.com/docs","inLanguage":"sq-AL","isPartOf":{"@type":"WebSite","name":"pjespjes.com","url":"https://pjespjes.com"},"about":["pjespjes.com API","OpenAPI","OAuth 2.0","MCP","CLI"]}
```