Beskrivning
Generell tjänst för att hantera medborgares
och organisationers inställningar för hur återkoppling ska ske (för till exempel felanmälningar och driftstörningar).
Livscykelstatus
Produktion
Lösningsbeskrivning
| Gliffy |
|---|
|
|
|
|
API specifikation
Förslag (exempel):
POST /
Input:
| Code Block | ||
|---|---|---|
| ||
{
"mobileNumber" : "0701234567",
"emailAddress" : "test@test.se",
"personId" : "435rfret45", //optional
"primaryContactMethod" : "sms",
"feedbackSetting" : "ON"
} |
GET /{searchValue}/?searchBy=<mobileNumber || emailAddress || personId>
Output:
| Code Block | ||
|---|---|---|
| ||
{
"id" : "545445",
"mobileNumber" : "0701234567",
"emailAddress" : "test@test.se",
"personId" : "435rfret45", //optional
"primaryContactMethod" : "sms",
"feedbackSetting" : "ON"
} |
PATCH /
Input:
| Code Block | ||
|---|---|---|
| ||
{
"id" : "545445",
"mobileNumber" : "0701234567",
"emailAddress" : "test@test.se",
"personId" : "435rfret45", //optional
"primaryContactMethod" : "sms",
"feedbackSetting" : "ON"
} |
DELETE /{id}
API-ägare
<Kontaktuppgifter till den verksamhet som äger APIets livscykel>
Teknisk ägare
<Kontaktuppgifter till utvecklare/teknisk förvaltare>
Länkar
<Länkar till dev-portal;
Test
Sandbox
Produktion>
FAQ
<FAQ>Hantering av personuppgifter
PersonId används för att knyta återkopplingsuppgifterna till en specifik individ. PersonId är obligatoriskt. I fall personen företräder en organisation så används personId i kombination med organisationsId för att knyta de återkopplingsuppgifter som gäller när personen företräder organisationen. Dvs, en person kan ha en specifik uppsättning återkopplingsuppgifter för personligt bruk samtidigt som hen har en annan uppsättning för respektive organisation som hen företräder. En organisation kan ha en eller flera företrädande personer.
En person eller företrädare för en organisation kan ha 0-n poster i listan över kontaktmetoder, men kan ej ha flera poster med samma innehåll. Dvs, hen kan tex bara ha en post med kontaktkanal SMS och destination 0701234567. Hen kan däremot ha flera poster för tex SMS, så länge destinationen skiljer sig åt mellan dem. Exempelvis:
| Code Block | ||
|---|---|---|
| ||
API specifikation
| Open api | ||
|---|---|---|
| ||
Säkerhetsklassning
Säkerhetsklass 1
Autentiseringsmetod: Oauth2
Teknisk ägare
För tekniska frågor: teamunmasked@sundsvall.se