Aplikacija daje tvom softveru pristup Softalon API-ju na adresi https://api.softalon.com/v1. Svaka aplikacija ima Client ID i Client Secret, pomoću kojih dobija pristupne tokene putem OAuth 2.0.
Postoje dvije vrste aplikacija:
Kreiraj aplikaciju salona
Prije nego što počnete
- Tvoj salon je na planu Ultimate.
- Imaš ulogu Super administrator ili Vlasnik.
- 1
Korak 1 od 5
Otvori Aplikacije
Idi na Postavke › Programeri › Aplikacije i klikni Kreiraj aplikaciju.
- 2
Korak 2 od 5
Imenuj aplikaciju
Unesi Naziv aplikacije. Ljudi vide ovaj naziv kada se od njih traži da autorizuju tvoju aplikaciju.
- 3
Korak 3 od 5
Dodaj opsege
U polje Opsezi dodaj svaku dozvolu koja je tvojoj aplikaciji potrebna, jednu po jednu. Tvoja aplikacija može tražiti samo opsege koje ovdje dodaš. Pogledaj listu opsega ispod.
- 4
Korak 4 od 5
Dodaj redirect URI-je
U polje Redirect URI-ji dodaj svaki puni URL koji tvoja aplikacija koristi za primanje OAuth odgovora, na primjer
https://app.example.com/oauth/callback. Tvoja aplikacija može koristiti samo URI-je koje ovdje dodaš. Ovo možeš preskočiti ako tvoja aplikacija s API-jem komunicira samo sa servera. - 5
Korak 5 od 5
Kreiraj aplikaciju i sačuvaj secret
Klikni Kreiraj aplikaciju.
Vidjet ćete:Dijalog s pristupnim podacima, s tvojim Client ID i Client Secret.
Odmah kopiraj oba i sačuvaj ih na sigurnom mjestu.
Client Secret se prikazuje samo jednom. Nakon što zatvoriš dijalog, tabela prikazuje maskiranu verziju. Ako izgubiš secret, obriši aplikaciju i kreiraj novu.
Kreiraj aplikaciju naloga
Idi na Nalog › Aplikacije i klikni Registruj aplikaciju. Polja i jednokratni prikaz secreta rade isto kao kod aplikacije salona.
Opsezi
Opsezi imaju oblik area:action.
Dodaj samo opsege koji su tvojoj aplikaciji potrebni.
Dobijanje tokena
Aplikacije podržavaju ove OAuth 2.0 vrste odobrenja:
- Client credentials, za pristup server-server bez korisnika.
- Authorization code, kada se osoba prijavi i odobri tvoju aplikaciju. Pogledaj Dozvoli aplikaciji pristup svom nalogu.
- Refresh token, za dobijanje novih pristupnih tokena bez ponovnog traženja odobrenja.
Kada tvoja aplikacija traži token, šalje svoj Client ID i Client Secret putem HTTP Basic autentifikacije.
Uredi ili obriši aplikaciju
Otvori meni aplikacije u tabeli:
- Ažuriraj mijenja naziv, opsege ili redirect URI-je. Client ID i Client Secret ostaju isti.
- Obriši uklanja aplikaciju i njene pristupne podatke. Nijedan sistem koji ih koristi više ne može dobiti tokene.
Česta pitanja
Ne. Prikazuje se samo kada se aplikacija kreira. Obriši aplikaciju i kreiraj novu da dobiješ novi secret.