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.jsonapplication/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.jsonapplication/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.txttext/plain
Një udhëzues i shkurtër se çfarë është SportyPlus, për kë është dhe cilat faqe kanë rëndësi.
- /sitemap_index.xmlapplication/xml
Indeksi i sitemap-eve — një sitemap për çdo gjuhë, që rendit çdo URL kanonike.
- /robots.txttext/plain
Politika e indeksimit (crawl). Asgjë në këtë faqe nuk është e ndaluar.
- /feed.xmlapplication/rss+xml
Feed i blogut në RSS 2.0.
- /feed.atomapplication/atom+xml
Feed i blogut në Atom 1.0.
- /feed.jsonapplication/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/pricingNë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.mdPë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/pricingURL-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.plusConnect 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-configurationapplication/json
OpenID Connect discovery. Everything an OIDC library needs: endpoints, supported scopes, signing algorithms.
- api.sporty.plus/.well-known/oauth-authorization-serverapplication/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 → 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
English
Hrvatski
Slovenščina
Српски
Македонски
Deutsch
Português (BR)
Italiano
Español
Français
Slovenčina
Ελληνικά
Čeština
Dansk
Eesti
Polski
Magyar
Български
Română
Shqip