---
title: "Burime për zhvillues dhe agjentë — SportyPlus"
description: "Burime të SportyPlus të lexueshme nga makina: specifikimi OpenAPI, llms.txt, sitemap-et, feed-et e blogut dhe negocimi i përmbajtjes në markdown në çdo faqe."
lang: "sq"
canonical: "https://www.sporty.plus/sq/developers"
---

# Burimet e SportyPlus për zhvillues dhe agjentë

## Gjithçka në këtë faqe që mund ta lexojë një makinë

### SportyPlus është softuer për menaxhimin e klubeve të tenisit, padelit dhe pickleball-it. Kjo faqe rendit përshkrimet e sporty.plus të lexueshme nga makina dhe si të merren faqet e tij në formatin markdown.

## Skedarë të lexueshëm nga makina

URL të qëndrueshme. Asnjëra prej tyre nuk kërkon autentikim.

-   [/openapi.json](https://www.sporty.plus/openapi.json)application/json
    
    Përshkrim OpenAPI 3.1 i gjithçkaje që shërben kjo faqe interneti — faqet, paraqitjet e tyre në markdown, sitemap-et dhe feed-et.
    
-   [/v1/openapi.json](https://www.sporty.plus/v1/openapi.json)application/json
    
    I njëjti dokument në një URL me version të fiksuar. Ndryshimet që prishin përputhshmërinë e kontratës dalin si version i ri; ky vazhdon të përshkruajë v1.
    
-   [/llms.txt](https://www.sporty.plus/llms.txt)text/plain
    
    Një udhëzues i shkurtër se çfarë është SportyPlus, për kë është dhe cilat faqe kanë rëndësi.
    
-   [/sitemap\_index.xml](https://www.sporty.plus/sitemap_index.xml)application/xml
    
    Indeksi i sitemap-eve — një sitemap për çdo gjuhë, që rendit çdo URL kanonike.
    
-   [/robots.txt](https://www.sporty.plus/robots.txt)text/plain
    
    Politika e indeksimit (crawl). Asgjë në këtë faqe nuk është e ndaluar.
    
-   [/feed.xml](https://www.sporty.plus/feed.xml)application/rss+xml
    
    Feed i blogut në RSS 2.0.
    
-   [/feed.atom](https://www.sporty.plus/feed.atom)application/atom+xml
    
    Feed i blogut në Atom 1.0.
    
-   [/feed.json](https://www.sporty.plus/feed.json)application/feed+json
    
    Feed i blogut në JSON Feed 1.1.
    

## Markdown në vend të HTML

Çdo faqe këtu shërben një paraqitje në markdown nga URL-ja e saj kanonike kur e kërkoni. Dërgoni Accept: text/markdown dhe merrni tekstin pa navigim, skripte apo shënjim faqosjeje.

```
curl -H "Accept: text/markdown" https://www.sporty.plus/pricing
```

Nëse klienti juaj nuk mund të vendosë header-a kërkese, shtoni .md në fund të çdo shtegu (faqja kryesore është /index.md):

```
curl https://www.sporty.plus/pricing.md
```

Përgjigjet përmbajnë Vary: Accept, dhe varianti HTML e njofton variantin e vet në markdown me header-in Link: rel="alternate". Një header Accept që përjashton si text/html ashtu edhe text/markdown merr 406.

## Versionimi dhe gabimet

Çdo përgjigje përmban header-in API-Version që emërton kontratën që e prodhoi — aktualisht 1. Një kërkesë mund ta fiksojë versionin duke dërguar të njëjtin header; një version që nuk e shërbejmë refuzohet me 400 në vend që të përgjigjet me një version tjetër.

```
curl -H "API-Version: 1" https://www.sporty.plus/pricing
```

URL-të e faqeve nuk versionohen kurrë. Ajo që emërton versioni është kontrata rreth tyre: paraqitja në markdown, alias-i .md, trupi i gabimit dhe këto dokumente zbulimi.

Ndryshimet që prishin përputhshmërinë dalin si API-Version i ri; ndryshimet shtuese jo. Një version i zëvendësuar vazhdon të funksionojë të paktën 6 muaj nga njoftimi, dhe gjatë kohës që po tërhiqet, përgjigjet e tij përmbajnë header-at Deprecation dhe Sunset (RFC 9745, RFC 8594).

Gabimet janë të tipizuara. Një klient që pranon application/json merr skemën Error nga dokumenti OpenAPI; një klient që pranon markdown merr të njëjtin dështim si faqe markdown me lidhje të mëtejshme; shfletuesit marrin faqen HTML të gabimit.

## Dokumentacioni i produktit

Si funksionon vetë aplikacioni SportyPlus — modulet, konfigurimi dhe operacionet e përditshme të klubit.

[docs.sporty.plus](https://docs.sporty.plus/)

## Connect your app with OAuth

SportyPlus is an OAuth 2.1 and OpenID Connect provider. Ask a club member for permission, get a scoped access token, and read only what they agreed to — no passwords, and they can revoke you at any time. Any standard OAuth or OIDC client library works.

-   [api.sporty.plus/.well-known/openid-configuration](https://api.sporty.plus/.well-known/openid-configuration)application/json
    
    OpenID Connect discovery. Everything an OIDC library needs: endpoints, supported scopes, signing algorithms.
    
-   [api.sporty.plus/.well-known/oauth-authorization-server](https://api.sporty.plus/.well-known/oauth-authorization-server)application/json
    
    OAuth 2.1 authorization server metadata, including the dynamic registration endpoint MCP and AI clients use.
    

Point your library at the discovery document and it will configure itself:

```
curl https://api.sporty.plus/.well-known/openid-configuration
```

[Read the OAuth documentation →](https://docs.sporty.plus/oauth)

## API-ja e produktit

API-ja e aplikacionit SportyPlus kërkon autentikim dhe nuk është publike. Nëse po ndërtoni një integrim për klubin tuaj, na shkruani dhe do të flasim për qasjen.

[Pyesni për qasje në API](https://www.sporty.plus/sq/contact)
