Aplikacija tvom vlastitom softveru daje pristup Softalon API-ju na https://api.softalon.com/v1. Svaka aplikacija ima client ID i client secret, kojima putem OAuth 2.0 dobiva pristupne tokene.
Postoje dvije vrste aplikacija:
Stvaranje aplikacije salona
Prije nego što počneš
- 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 Stvori aplikaciju.
- 2
Korak 2 od 5
Imenuj aplikaciju
Unesi Naziv aplikacije. Ljudi vide taj naziv kad ih se traži da autoriziraju tvoju aplikaciju.
- 3
Korak 3 od 5
Dodaj opsege
U Opsezi dodaj svako dopuštenje koje tvoja aplikacija treba, jedno po jedno. Tvoja aplikacija može tražiti samo opsege koje ovdje dodaš. Pogledaj popis opsega u nastavku.
- 4
Korak 4 od 5
Dodaj redirect URI-je
U 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 komunicira s API-jem samo s poslužitelja. - 5
Korak 5 od 5
Stvori aplikaciju i spremi secret
Klikni Stvori aplikaciju.
Vidjet ćeš:Dijalog s podacima za prijavu, s tvojim Client ID i Client Secret.
Odmah kopiraj oboje i spremi na sigurno mjesto.
Client secret prikazuje se samo jednom. Nakon što zatvoriš dijalog, tablica prikazuje maskiranu verziju. Ako izgubiš secret, izbriši aplikaciju i stvori novu.
Stvaranje aplikacije računa
Idi na Račun › Aplikacije i klikni Registriraj aplikaciju. Polja i jednokratni secret rade isto kao kod aplikacije salona.
Opsezi
Opsezi imaju oblik area:action.
Dodaj samo opsege koje tvoja aplikacija treba.
Dobivanje tokena
Aplikacije podržavaju ove OAuth 2.0 vrste odobrenja:
- Client credentials, za pristup između poslužitelja bez korisnika.
- Authorization code, kad se osoba prijavi i odobri tvoju aplikaciju. Pogledaj Dopuštanje aplikaciji pristupa tvom računu.
- Refresh token, za dobivanje novih pristupnih tokena bez ponovnog traženja.
Kad tvoja aplikacija traži token, šalje svoj client ID i secret putem HTTP Basic autentifikacije.
Uređivanje ili brisanje aplikacije
Otvori izbornik aplikacije u tablici:
- Ažuriraj mijenja naziv, opsege ili redirect URI-je. Client ID i secret ostaju isti.
- Izbriši uklanja aplikaciju i njezine podatke za prijavu. Nijedan sustav koji ih koristi više ne može dobiti tokene.
Česta pitanja
Ne. Prikazuje se samo kad se aplikacija stvori. Izbriši aplikaciju i stvori novu da dobiješ novi secret.