Kalo te përmbajtja

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/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

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.

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