// Portali për zhvillues

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

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.

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.

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