OAuth i prijava putem Sportyja

Opsezi

Svaki opseg, kako se njegovo značenje opisuje članu i koje ga vrste klijenata smiju tražiti.

Tražite najmanje što vam treba. Zaslon za privolu članu prikazuje opis naveden u nastavku, od riječi do riječi, pa je dugačak popis opsega ujedno dugačak popis razloga za odbijanje.

Sve što nije na ovom popisu odbija se s invalid_scope.

Neki su opsezi imenovani prije nego što ih API podržava. Opseg označen s Još ne može se zatražiti i član ga može odobriti, ali na njega još ne odgovara nijedna krajnja točka, pa token koji ga ima time ne dobiva ništa više. Gradite na opsezima označenima s Da. Discovery dokumenti (/.well-known/oauth-authorization-server i ostali) u scopes_supported oglašavaju upravo njih, a opseg se ondje pojavljuje onoga dana kad ga neka krajnja točka počne posluživati.

Identitet

Opseg	Što se kaže članu	Dostupno
`openid`	Potvrditi tko ste	Da
`profile`	Vidjeti vaše ime i profilnu sliku	Da
`email`	Vidjeti vašu adresu e-pošte	Da

Podaci samog člana

Opseg	Što se kaže članu	Dostupno
`me.read`	Vidjeti vaš osnovni profil	Da
`me.reservations.read`	Vidjeti vaše rezervacije terena	Da
`me.reservations.write`	Rezervirati i otkazivati terene u vaše ime	Da
`me.purchases.write`	Kupovati termine na terenu u vaše ime, karticom koju date aplikaciji	Da, kupnja putem agenta
`me.results.read`	Vidjeti vaše rezultate mečeva	Da
`me.memberships.read`	Vidjeti kojim klubovima pripadate	Da

Podaci kluba

Opseg	Što se kaže članu	Dostupno
`club.read`	Vidjeti javne podatke kluba	Da
`club.members.read`	Vidjeti članove kluba	Da
`club.members.write`	Dodavati i ažurirati članove kluba	Da
`club.courts.read`	Vidjeti terene kluba	Da
`club.reservations.read`	Vidjeti rezervacije kluba	Da
`club.reservations.write`	Stvarati i otkazivati rezervacije kluba	Da
`club.checkout.write`	Prodavati termine kluba gostima koje dovede aplikacija	Da, kupnja putem agenta
`club.events.read`	Vidjeti događaje kluba	Još ne
`club.shop.orders.read`	Vidjeti narudžbe iz klupske trgovine	Još ne

Partner

Samo client credentials — ovi opsezi opisuju aplikaciju koja djeluje bez prisutnog člana.

Opseg	Značenje	Dostupno
`partner.members.provision`	Stvarati članove u ime partnera	Još ne
`partner.login.handoff`	Prijaviti člana iz partnerske aplikacije	Da

Tko smije tražiti što

Klijent	Smije tražiti
Registrirao ga je administrator kluba, ili mi	`openid`, `profile`, `email`, `me.`, `club.`
Samoregistriran (dinamički)	`openid`, `profile`, `email`, `me.*` — nikad podatke kluba
Client credentials	`partner.`, `club.` — `me.*` bez člana nema smisla

Za `club.*` potrebno je i dopuštenje kluba

Imati opseg club.* nije isto što i smjeti ga koristiti.

Prije nego što opseg club.* išta učini, moraju pristati tri odvojene strane:

Sporty je odobrio vašu aplikaciju;
administrator kluba vašoj je aplikaciji odobrio taj klub i taj opseg;
član (ako ga ima) autorizirao je vašu aplikaciju za taj klub.

Svaka od te tri strane može samostalno povući pristanak, u bilo kojem trenutku, i vaš pristup tada prestaje. Ako vam klub nije odobrio pristup, pozivi odgovaraju 403 access_denied s porukom da vas administrator najprije mora odobriti — to nije pogreška zbog koje treba pokušati ponovno, nego zbog koje treba otići i pitati.

Za koji klub token djeluje

To nam nikad ne govorite u tijelu zahtjeva; zaključujemo to iz vašeg klijenta.

Klijent koji pripada jednom klubu uvijek djeluje za taj klub.
Klijent kojem je odobreno više klubova mora jedan navesti zaglavljem X-Club. Bez njega dobivate 400 club_required. Zaglavlje bira među klubovima koji su vam već odobreni — ne može vam dati novi.

GET /api/partner/v1/clubs/me kaže vam za koji je klub token na kraju djelovao.

Uredi ovu stranicuiliPrijavi problem

Tok authorization code

Cijeli tok sa stvarnim zahtjevima, od slanja osobe na Sporty do osvježavanja tokena.

Prijava putem Sportyja

OpenID Connect — id_token, njegovi claimovi, /userinfo i provjera potpisa.