Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Beskrivning
Hanterar data kopplad till personer som arbetar eller verkar inom organisationen Sundsvalls kommun eller kommunala bolag
Livscykelstatus
Under utveckling
Lösningsbeskrivning
| Gliffy | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Hantering av personuppgifter
Uppgifter så som namn, adress, telefonnummer och e-post hanteras av API:et då det är nödvändigt för att arbetsgivaren ska kunna jobba med bland annat löneärenden, HR-ärenden eller andra ärenden mellan arbetsgivare och arbetstagare. Data används även för access till olika system som används inom organisationen.
API specifikation
Hämta domän och inloggningsnamn från personnummer
Exempelanrop:
GET
/employee/v1/employed/{personalNumber}/loginName
Returnerar en lista med domän och inloggningsnamn för person med angivet personnummer.
Svar:
| Code Block | ||
|---|---|---|
| ||
[
{
"domain": "string",
"loginName": "string"
}
] |
Hämta information om person från användarnamn
Exempelanrop:
GET
/employee/v1/portalpersondata/{domain}/{loginName}
Returnerar information om person utifrån domän (domain t.ex. ‘PERSONAL’) och användarnamn ( loginName t.ex. 'kat11tla').
Svar:
| Code Block | ||
|---|---|---|
| ||
{
"personid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"givenname": "string",
"lastname": "string",
"fullname": "string",
"address": "string",
"postalCode": "string",
"city": "string",
"workPhone": "string",
"mobilePhone": "string",
"extraMobilePhone": "string",
"aboutMe": "string",
"email": "string",
"mailNickname": "string",
"company": "string",
"companyId": 0,
"orgTree": "string",
"referenceNumber": "string"
} |
Hämta information om person från e-post
Exempelanrop:
GET
/employee/v1/portalpersondata/{email}
Returnerar information om person utifrån e-post (email t.ex robin.robinsson@sundsvall.se).
Svar:
| Code Block | ||
|---|---|---|
| ||
{
"personid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"givenname": "string",
"lastname": "string",
"fullname": "string",
"address": "string",
"postalCode": "string",
"city": "string",
"workPhone": "string",
"mobilePhone": "string",
"extraMobilePhone": "string",
"aboutMe": "string",
"email": "string",
"mailNickname": "string",
"company": "string",
"companyId": 0,
"orgTree": "string",
"referenceNumber": "string"
} |
Säkerhetsklassning
Säkerhetsklass TBD
Autentiseringsmetod: Oauth2
(Ref: Säkerhetsklassning av APIer )
API-ägare
<Kontaktuppgifter till den verksamhet som äger APIets livscykel>
Teknisk ägare
https://sundsvall.atlassian.net/wiki/spaces/META
För tekniska frågor: joel.lindberg@sundsvall.se, marcus.olsson@xpservices.se
Länkar
<Länkar till dev-portal;
Test
Sandbox
Produktion>
FAQ
<FAQ>