API: Rejestracja (konta i profile): Różnice pomiędzy wersjami

Z DrRobert DOCS
Przejdź do nawigacji Przejdź do wyszukiwania
WizualnieWikikod
(Utworzono nową stronę "== POST /user/signup == Endpoint służący utworzeniu konta użytkownika, zwraca token uwierzytelniania. === Parametry JSON === {| class="wikitable" !Klucz !Typ !Przykład !Opis !Wymagane |- |name |string | | |Tak |- |phone |string | | | |- |email |string | | | |- |organization_id |integer | | | |- |agreements |array | | | |- |app_signature |string |SDrRobSvWeb |Podpis aplikacji |Tak |- |app_version |string |1.0.1-20231121 |Wersja aplikacji |Tak |} ==== Odpowied…")
 
Nie podano opisu zmian
 
(Nie pokazano 19 wersji utworzonych przez 2 użytkowników)
Linia 9: Linia 9:
!Opis
!Opis
!Wymagane
!Wymagane
!Walidacja
|-
|-
|name
|name
|string
|string
|Jan Kowalski
|Nazwa użytkownika: imię lub imię i nazwisko
|Nie
|Długość: 50
|-
|firstname
|string
|Jan
|Imię użytkownika
|Tak
|
|
|-
|lastname
|string
|Kowalski
|Nazwisko użytkownika
|Tak
|
|
|Tak
|-
|pesel
|string
|99062873619
|PESEL użytkownika
|Nie
|czy prawidłowy pesel
|-
|-
|phone
|phone
|string
|string
|
| +48699999999
|
|Telefon
|
|Tak
|Cyfry i znak +; Długość: 20
|-
|-
|email
|email
|string
|string
|
|jankowalski@domena.pl
|
|E-mail
|
|Tak
|Adres email zgodny z RFC 5322 i RFC 6854, unikalny w skali serwisu
|-
|password
|string
|BardzoTrudneHasło123
|Nadane hasło
|Tak
|Minimum 8 dowolnych znaków
|-
|-
|organization_id
|organisation_id
|integer
|integer
|
|1
|
|Organizacja (Placówka POZ)
|
|Nie
|ID organizacji (lista w [[API: Zasoby publiczne i konfiguracje ogólne]])
|-
|-
|agreements
|agreements
|array
|array
|
|[1:true,2:true,3:false]
|
|Zgody prawne
|
|Nie
|Tablica z id zgody i wartością bool jej akceptacji (lista w [[API: Zasoby publiczne i konfiguracje ogólne]])
|-
|-
|app_signature
|anonymous_token
|string
|string
|SDrRobSvWeb
|2580f055d57a2a298cb899f8ede75edbb88f1c92
|Podpis aplikacji
|Token autoryzacji użytkownika anonimowego, gdy prawidłowo podany zamiast dodawać nowego użytkownika nastąpi przekształcenie użytkownika anonimowego na pełnoprawnego.
|Tak
|Nie
|-
|
|app_version
|string
|1.0.1-20231121
|Wersja aplikacji
|Tak
|}
|}
Należy pamiętać o wymaganych parametrach: [[API: Parametry]]


==== Odpowiedź poprawna ====
==== Odpowiedź poprawna ====
Linia 59: Linia 89:
'''JSON:'''
'''JSON:'''


<code><nowiki>{"auth":{"api_token":"2580f055d57a2a298cb899f8ede75edbb88f1c92","token_expire_dt":"2023-12-21T14:40:23"},"user":{"name":"Jan Testowy","email":"jankowalski@domena.pl"}}</nowiki></code>
<code><nowiki>{"error": "validation","validation":{"name": {"max": true},"phone": {"required": true},"email": {"email": true},"organization_id": [],"agreements": []}}</nowiki></code>
{| class="wikitable"
{| class="wikitable"
!Klucz
!Klucz
Linia 71: Linia 101:
|Informacja o typie błędu, tutaj walidacja
|Informacja o typie błędu, tutaj walidacja
|-
|-
|
|validation
|array
|{"name": {"max": true},"phone": {"required": true},"email": {"email": true,"unique":true},"password":{"min":true},"organization_id": [],"agreements": []}
|Tablica z błędami walidacji, lista pól i występujących błędów
|}
== POST /user/profile ==
Endpoint służący utworzeniu profilu przypisanego do użytkownika, zwraca dane profilu.
 
=== Parametry JSON ===
{| class="wikitable"
!Klucz
!Typ
!Przykład
!Opis
!Wymagane
!Walidacja
|-
|name
|string
|string
|2580f055d57a2a298cb899f8ede75edbb88f1c92
|Jan Kowalski
|Token uwierzytelnienia, należy go przechowywać w pamięci aplikacji, służy do autoryzowania w pozostałych endpointach api
|Nazwa profilu: imię lub imię i nazwisko
|Tak
|Długość: 50; Gdy puste ale podane firstname i lastname to są one łączone do name
|-
|-
|auth.token_expire_dt
|firstname
|datetime
|string
|2023-12-21T14:40:23
|Jan
|Data i czas wygaśnięcia tokenu
|Imię użytkownika
|Nie
|
|-
|-
|user
|lastname
|array
|string
|Kowalski
|Nazwisko użytkownika
|Nie
|
|
|Tablica z danymi użytkownika
|-
|-
|user.name
|pesel
|string
|string
|Jan Testowy
|99062873619
|Nazwa użytkownika
|PESEL użytkownika
|Nie
|czy prawidłowy pesel
|}
Należy pamiętać o wymaganych parametrach: [[API: Parametry]]
 
==== Odpowiedź poprawna ====
{| class="wikitable"
!Klucz
!Typ
!Przykład
!Opis
|-
|-
|user.email
|user
|string
|UserObject
|jankowalski@domena.pl
|[[API: UserObject]]
|E-mail użytkownika
|Obiekt profilu patrz: [[API: UserObject]]
|}
|}

Aktualna wersja na dzień 08:34, 24 lut 2026

POST /user/signup

Endpoint służący utworzeniu konta użytkownika, zwraca token uwierzytelniania.

Parametry JSON

Klucz Typ Przykład Opis Wymagane Walidacja
name string Jan Kowalski Nazwa użytkownika: imię lub imię i nazwisko Nie Długość: 50
firstname string Jan Imię użytkownika Tak
lastname string Kowalski Nazwisko użytkownika Tak
pesel string 99062873619 PESEL użytkownika Nie czy prawidłowy pesel
phone string +48699999999 Telefon Tak Cyfry i znak +; Długość: 20
email string jankowalski@domena.pl E-mail Tak Adres email zgodny z RFC 5322 i RFC 6854, unikalny w skali serwisu
password string BardzoTrudneHasło123 Nadane hasło Tak Minimum 8 dowolnych znaków
organisation_id integer 1 Organizacja (Placówka POZ) Nie ID organizacji (lista w API: Zasoby publiczne i konfiguracje ogólne)
agreements array [1:true,2:true,3:false] Zgody prawne Nie Tablica z id zgody i wartością bool jej akceptacji (lista w API: Zasoby publiczne i konfiguracje ogólne)
anonymous_token string 2580f055d57a2a298cb899f8ede75edbb88f1c92 Token autoryzacji użytkownika anonimowego, gdy prawidłowo podany zamiast dodawać nowego użytkownika nastąpi przekształcenie użytkownika anonimowego na pełnoprawnego. Nie

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

Odpowiedź poprawna

Identyczna jak w API: Autoryzacja

Odpowiedź niepoprawna walidacja

JSON:

{"error": "validation","validation":{"name": {"max": true},"phone": {"required": true},"email": {"email": true},"organization_id": [],"agreements": []}}

Klucz Typ Przykład Opis
error string validation Informacja o typie błędu, tutaj walidacja
validation array {"name": {"max": true},"phone": {"required": true},"email": {"email": true,"unique":true},"password":{"min":true},"organization_id": [],"agreements": []} Tablica z błędami walidacji, lista pól i występujących błędów

POST /user/profile

Endpoint służący utworzeniu profilu przypisanego do użytkownika, zwraca dane profilu.

Parametry JSON

Klucz Typ Przykład Opis Wymagane Walidacja
name string Jan Kowalski Nazwa profilu: imię lub imię i nazwisko Tak Długość: 50; Gdy puste ale podane firstname i lastname to są one łączone do name
firstname string Jan Imię użytkownika Nie
lastname string Kowalski Nazwisko użytkownika Nie
pesel string 99062873619 PESEL użytkownika Nie czy prawidłowy pesel

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

Odpowiedź poprawna

Klucz Typ Przykład Opis
user UserObject API: UserObject Obiekt profilu patrz: API: UserObject
Źródło: „https://docs.doctorrobert.com/index.php?title=API:_Rejestracja_(konta_i_profile)&oldid=372”