API: Autoryzacja: Różnice pomiędzy wersjami

Z DrRobert DOCS
Przejdź do nawigacji Przejdź do wyszukiwania
WizualnieWikikod
Nie podano opisu zmian
Nie podano opisu zmian
 
(Nie pokazano 13 pośrednich wersji utworzonych przez tego samego użytkownika)
Linia 18: Linia 18:
# api_token - dla tokenu przechowywanego w aplikacji
# api_token - dla tokenu przechowywanego w aplikacji
# url_token - dla tokenu pobranego z linka logowania
# url_token - dla tokenu pobranego z linka logowania
|Tak, zawsze
# anonymous - prośba o token dla użytkownika anonimowego
|Tak
|-
|-
|auth_login
|auth_login
Linia 38: Linia 39:
|Tak, gdy auth_method = *_token
|Tak, gdy auth_method = *_token
|}
|}
Należy pamiętać o wymaganych parametrach: [[API: Parametry]]


==== Odpowiedź JSON ====
=== Odpowiedź JSON ===
<code><nowiki>{"auth":{"api_token":"2580f055d57a2a298cb899f8ede75edbb88f1c92"},"user":{"name":"Jan Testowy","email":"jankowalski@domena.pl"}}</nowiki></code>
<code><nowiki>{"auth":{"api_token":"2580f055d57a2a298cb899f8ede75edbb88f1c92","token_expire_dt":"2023-12-21T14:40:23"},"user":{"name":"Jan Testowy","email":"jankowalski@domena.pl"}}</nowiki></code>
{| class="wikitable"
{| class="wikitable"
!Klucz
!Klucz
Linia 56: Linia 58:
|2580f055d57a2a298cb899f8ede75edbb88f1c92
|2580f055d57a2a298cb899f8ede75edbb88f1c92
|Token uwierzytelnienia, należy go przechowywać w pamięci aplikacji, służy do autoryzowania w pozostałych endpointach api
|Token uwierzytelnienia, należy go przechowywać w pamięci aplikacji, służy do autoryzowania w pozostałych endpointach api
|-
|auth.token_expire_dt
|datetime
|2023-12-21T14:40:23
|Data i czas wygaśnięcia tokenu
|-
|-
|user
|user
|array
|UserObject
|
|[[API: UserObject]]
|Tablica z danymi użytkownika
|Obiekt użytkownika patrz: [[API: UserObject]]
|}
 
== POST /user/reset ==
Endpoint służący resetowaniu dostępu użytkownika - "zapomniałem hasła"
 
Proces będzie przebiegał w 3 etapach:
 
# na pierwszym ekranie użytkownik wpisze email swojego konta,
# na drugim ekranie użytkownik może wpisać kod otrzymany mailem,
# na trzecim ekranie użytkownik wpisuje nowe hasło
 
=== Parametry JSON ===
{| class="wikitable"
!Klucz
!Typ
!Przykład
!Wymagane w kroku
!Opis
|-
|auth_login
|string
|jankowalski@domena.pl
|1, 2, 3
|Login użytkownika
|-
|reset_code
|string
|594834
|2, 3
|Kod potwierdzający otrzymany emailem
|-
|auth_password
|string
|BardzoTrudneHasło123
|3
|Nowe hasło
|}
Należy pamiętać o wymaganych parametrach: [[API: Parametry]]
 
=== Odpowiedź JSON ===
<code><nowiki>{"result":"ok"}}</nowiki></code>
{| class="wikitable"
!Klucz
!Typ
!Przykład
!Opis
|-
|-
|user.name
|result
|string
|string
|Jan Testowy
|ok
|Nazwa użytkownika
|ok - poprawnie przetworzona prośba, należy przejść do kolejnego kroku
error - błąd przetwarzania
|-
|-
|user.email
|error
|string
|string
|jankowalski@domena.pl
|wrong_reset_code
|E-mail użytkownika
|Kod błędu:
 
* wrong_reset_code - błędny kod
* wrong_login - błędny login
* wrong_password - błędne hasło (min 8 znaków)
* no_input - brak argumentów
|}
|}

Aktualna wersja na dzień 08:40, 28 mar 2024

POST /user/auth

Endpoint służący otrzymania danych użytkownika w tym tokenu uwierzytelniania, logowanie przy pomocy loginu i hasła lub uwierzytelnienie wcześniej otrzymanym tokenem.

Parametry JSON

Klucz Typ Przykład Opis Wymagane
auth_method string credentials Metoda uwierzytelnienia:
  1. credentials - dla loginu i hasła
  2. api_token - dla tokenu przechowywanego w aplikacji
  3. url_token - dla tokenu pobranego z linka logowania
  4. anonymous - prośba o token dla użytkownika anonimowego
 Tak
auth_login string jankowalski@domena.pl Login użytkownika Tak, gdy auth_method = credentials
auth_password string BardzoTrudneHasło123 Hasło użytkownika Tak, gdy auth_method = credentials
auth_token string 2580f055d57a2a298cb899f8ede75edbb88f1c92 Token uwierzytelnienia Tak, gdy auth_method = *_token

Należy pamiętać o wymaganych parametrach: API: Parametry

Odpowiedź JSON

{"auth":{"api_token":"2580f055d57a2a298cb899f8ede75edbb88f1c92","token_expire_dt":"2023-12-21T14:40:23"},"user":{"name":"Jan Testowy","email":"jankowalski@domena.pl"}}

Klucz Typ Przykład Opis
auth array Tablica z danymi autoryzacji
auth.api_token string 2580f055d57a2a298cb899f8ede75edbb88f1c92 Token uwierzytelnienia, należy go przechowywać w pamięci aplikacji, służy do autoryzowania w pozostałych endpointach api
auth.token_expire_dt datetime 2023-12-21T14:40:23 Data i czas wygaśnięcia tokenu
user UserObject API: UserObject Obiekt użytkownika patrz: API: UserObject

POST /user/reset

Endpoint służący resetowaniu dostępu użytkownika - "zapomniałem hasła"

Proces będzie przebiegał w 3 etapach:

  1. na pierwszym ekranie użytkownik wpisze email swojego konta,
  2. na drugim ekranie użytkownik może wpisać kod otrzymany mailem,
  3. na trzecim ekranie użytkownik wpisuje nowe hasło

Parametry JSON

Klucz Typ Przykład Wymagane w kroku Opis
auth_login string jankowalski@domena.pl 1, 2, 3 Login użytkownika
reset_code string 594834 2, 3 Kod potwierdzający otrzymany emailem
auth_password string BardzoTrudneHasło123 3 Nowe hasło

Należy pamiętać o wymaganych parametrach: API: Parametry

Odpowiedź JSON

{"result":"ok"}}

Klucz Typ Przykład Opis
result string ok ok - poprawnie przetworzona prośba, należy przejść do kolejnego kroku

error - błąd przetwarzania

error string wrong_reset_code Kod błędu:
  • wrong_reset_code - błędny kod
  • wrong_login - błędny login
  • wrong_password - błędne hasło (min 8 znaków)
  • no_input - brak argumentów
Źródło: „https://docs.doctorrobert.com/index.php?title=API:_Autoryzacja&oldid=199”