Prvým krokom, ktorý je nutné vykonať je prihlásenie sa.

Prihlásime sa do aplikácie my.sportnet.online, na ktorú by mal byť používateľ presmerovaný pri kluknutí na tlačidlo "Prihlásiť sa"

Po prihlásení sme presmerovaní na stránku, kde autoriyujeme aplikáciu.

Ak je používateľ už prihlásený na my.sportnet.online, krok s prihlásením je preskočený a používateľovi sa zobrazí priamo stránka s možnosťou autorizovať aplikáciu.

Používateľ prihlásený do aplikácie vidí všetky organizácie, v ktorých je registrovaný ako osoba oprávnená vykonávať zmeny.

Po kliknutí na položku sa otvorí jej detail - Základný profil organizácie

- API endpoint GET (/organizations/{organization_id}/profile )

Taktiež môže používateľ zobraziť zoznam profilov vybratej organizácie

- API endpoint GET /organizations/{organization_id}/profiles

Používateľ si vie prezrieť aj detail profilu s jeho základnými údajmi.

- Api endpoint GET /organizations/{organization_id}/profiles/{profile_id}

Ako prihlásený používateľ s nastavenou rolou users_admin viem získať zoznam športovcov evidovaných vrámci športovej organizácie. Používateľ musí byť evidovaný vrámci danej organizácia ako autorizovaná osoba ako manažér, alebo tréner (manager/ coach).

- API endpoint GET /organizations/{organization_id}/athletes

na tomto endpointe je možnosť zadania URL parametra "profile_id" ktorý vyfiltruje športovcov prislúchajúcich k danému profilu.

Taktiež je možné použiť:

- API endpoint GET /organizations/{organization_id}/profiles/{profile_id}/athletes

Vyplnenie žiadosti o registráciu:

Používateľ vyplní formulár (povinné údaje uvedené v schéme).

Odoslaním formulára sa odošle POST request, ktorý overí potrebné informácie a vytvorí požiadavku na vytvorenie športovca.

- API endpoint POST /registration/athlete-request

Príklad requestu:

{
"user_profile": {
"surname": "Janko",
"name": "Hrasko",

"username": "jankohrasko1",
"sex": "M",
"idnr": "92012564585"
},
"sport_org": {
"sport": "futbal",
"sport_sector": "muzi",
"sport_discipline": "trava",
"competence_type": "player",
"org_id": "5915afcb5e069c76b5102395",
"org_profile_id": "a896cb4e19b5422fbd1b3a96f1e5e3a7"
}
}

Aby bola požiadavka zaregistrovaná, musí platiť:

Formulár musí mať vyplnené všetky povinné polia
V databáze musí existovať organizácia, do ktorej chceme osobu pridať
Daná organizácia musí mať profil, do ktorého chceme osobu pridať
Username, ktoré sme zadali musí byť jedinečné
Používateľ ktorý osobu pridáva musí byť evidovaný ako autorizovaná osoba organizácie a vrámci organizácie musí mať rolu manažér, alebo tréner

Ak tieto podmienky neboli splnené, aplikácia vráti chybu:

(400) EMPTY_BODY - Neposlali sa žiadne dáta
(400) INVALID_SCHEMA - Neboli zadané všetky potrebné dáta
(401) UNAUTHORIZED - Používateľ nie je prihlásený - platnosť tokenu vypršala
(403) USER_NOT_AUTHORIZED - Používateľ nie je autorizovaný organizáciou
(403) REQUIRED_ROLE_MISSING - Používateľ nemá vrámci organizácie rolu manažér / tréner
(404) ORGANIZATION_PROFILE_NOT_FOUND - Nenašiel sa záznam v databáze s údajmi o organizácii / profile organizácie
(409) USERNAME_ALREADY_EXISTS - Používateľské meno je už registrované / rezervované

Ak sa vyhneme všetkým týmto chybám, požiadavka bude zaregistrovaná a na zadanú emailovú adresu sa zašle verifikačný email s odkazom na detal požiadavky o registráciu. Na tejto stránke si používateľ (v tomto prípade rodič, resp. poverená osoba) môže žiadosť potvrdiť, alebo zamietnuť. Po potvrdení / zamietnutí sa mení status požiadavky, takže túto operáciue je možné vykonať len raz.

Po potvrdení registrácie sa zaregistruje používateľ do databázy. Následne si pre prihlásenie cez my.sportnet.online zresetuje heslo a môže sa prihlásiť.

- API endpoint POST /registration/request/{request_id}/commit

Zamietnutie požiadavky:

- API endpoint DELETE /registration/request/{request_id}

Detail požiadavky na registráciu:

- API endpoint GET /registration/request/{request_id}

Celá dokumentácia - https://my.sportnet.online/docs

Vytvorenie a správa žiadostí

1. Vytvorenie žiadosti

2. Schválenie žiadosti

3. Potvrdenie žiadosti