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 preko OAuth 2.0.
Postoje dve vrste aplikacija:
Kreiraj aplikaciju salona
Pre nego što počneš
- Tvoj salon koristi plan Ultimate.
- Imaš ulogu Super administrator ili Vlasnik.
- 1
Korak 1 od 5
Otvori Aplikacije
Idi na Podešavanja › Programeri › Aplikacije i klikni na Kreiraj aplikaciju.
- 2
Korak 2 od 5
Daj ime aplikaciji
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 jednu po jednu dozvolu koja je potrebna tvojoj aplikaciji. Tvoja aplikacija može da traži samo opsege koje ovde dodaš. Pogledaj listu opsega u nastavku.
- 4
Korak 4 od 5
Dodaj URI-jeve za preusmeravanje
U polje URI-jevi za preusmeravanje dodaj svaki pun URL koji tvoja aplikacija koristi za prijem OAuth odgovora, na primer
https://app.example.com/oauth/callback. Tvoja aplikacija može da koristi samo URI-jeve koje ovde dodaš. Ovaj korak možeš da preskočiš ako tvoja aplikacija komunicira sa API-jem samo sa servera. - 5
Korak 5 od 5
Kreiraj aplikaciju i sačuvaj secret
Klikni na Kreiraj aplikaciju.
Videćeš:Prozor sa kredencijalima, u kom su tvoj Client ID i Client Secret.
Odmah kopiraj oba podatka i sačuvaj ih na sigurnom mestu.
Client Secret se prikazuje samo jednom. Kada zatvoriš prozor, tabela prikazuje maskiranu verziju. Ako izgubiš secret, obriši aplikaciju i kreiraj novu.
Kreiraj aplikaciju naloga
Idi na Nalog › Aplikacije i klikni na Registruj aplikaciju. Polja i jednokratni prikaz secreta rade isto kao kod aplikacije salona.
Opsezi
Opsezi imaju oblik area:action (oblast:akcija).
Dodaj samo opsege koji su potrebni tvojoj aplikaciji.
Dobijanje tokena
Aplikacije podržavaju ove OAuth 2.0 tipove odobrenja:
- Client credentials, za pristup između servera 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 pomoću HTTP Basic autentifikacije.
Izmeni ili obriši aplikaciju
Otvori meni aplikacije u tabeli:
- Ažuriraj menja naziv, opsege ili URI-jeve za preusmeravanje. Client ID i Client Secret ostaju isti.
- Obriši uklanja aplikaciju i njene kredencijale. Nijedan sistem koji ih koristi više ne može da dobije tokene.
Česta pitanja
Ne. Prikazuje se samo kada se aplikacija kreira. Obriši aplikaciju i kreiraj novu da dobiješ novi secret.