OpenAPI namnsättning

Här samlar vi gemensamma namn och format på vanligt förekommande parametrar och objekt i våra API:er. Detta gör vi för att få en enhetlig design på våra API:er och för att underlätta för klienterna.

Gemensamma fält

Namn

Datatyp

Format (exempel)

Regex

Beskrivning

Namn

Datatyp

Format (exempel)

Regex

Beskrivning

personalNumber

String

199001010101

^(19|20)[0-9]{10}$

Personnummer

Skall endast användas i absoluta undantagsfall i våra API:er - använd i stället personId!

personId

String

15aee472-46ab-4f03-9605-68bd64ebc73f

^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$

Unik identifierare för en person (UUID)

caseId

String

-

-

Ärende-id

customerNumber

String

-

-

Kundnummer

mobileNumber

String

0701234567

^07[02369]\d{7}$

Mobilnummer

emailAddress

String

test.testsson@test.se

^((([!#$%&'*+\-/=?^_`{|}~\w])|([!#$%&'*+\-/=?^_`{|}~\w][!#$%&'*+\-/=?^_`{|}~\.\w]{0,}[!#$%&'*+\-/=?^_`{|}~\w]))[@]\w+([-.]\w+)*\.\w+([-.]\w+)*)$

E-postadress

organizationNumber

String

5591621234

^([1235789][\d][2-9]\d{7})$

Organisationsnummer

Skall endast användas i absoluta undantagsfall i våra API:er - använd i stället organizationId!

organizationId

String

15aee472-46ab-4f03-9605-68bd64ebc73f

^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$

Unik identifierare för en organisation (UUID)

partyId

String

cb88e940-bbb4-470d-8908-826021945e4f

^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$

Unik identifierare för en intressent (UUID)

Ett gemensamt attributnamn som rymmer både “personId” och “organizationId”. Ett “partyId” kan m.a.o. peka ut både personer och organisationer. Används t.ex. i de fall där den unika identifieraren antingen kan vara ett “personId” eller ett “organizationId”, men där det inte är relevant att hålla reda på om identifieraren tillhör en fysisk eller juridisk person.

municipalityId

String

2076

^d{4}$

Kommun-id för APIer som skall återanvändas för flera kommuner.

Gemensamma objekt

Här samlar vi gemensamma objekt som vi kan återanvända i våra API:er.

Attachment

Bilagor, filer, dokument.

“category” är en kategorisering av bilagan och innehållet i detta fält kan skilja från API till API.

"attachment": { "category": "ANSOKNINGSHANDLING", "name": "Namn på dokumentet", "extension": "PDF", "mimeType": "application/pdf", "note": "En anteckning", "file": "base64" }

Address

Adress till privatperson eller organisation. Det är inte obligatoriskt att använda alla fält. Välj de som är relevanta för den specifika applikationen.

Beskrivning inom parentes.

"address": { "street": "Kometvägen", (Gatunamn) "houseNumber" : "1", (Husnummer) "appartmentNumber": "LGH 1001", (Lägenhetsnummer) "postalCode": "812 34", (Postnummer) "city": "SUNDSVALL", (Stad) "country": "Sverige", (Land) "careOf": "Test Testsson", (c/o) "attention": "Test Testsson", (Namn på den person inom en organisation som brev ska tillställas) "propertyDesignation": "SUNDSVALL NORRMALM 1:1", (Fastighetsbeteckning) "emigrated": false, "addressType": "POPULATION_REGISTRATION_ADDRESS", (Folkbokföringsadress, särskild adress eller utländsk adress) "addressCategories": [ "POSTAL_ADDRESS", "INVOICE_ADDRESS", "VISITING_ADDRESS" (Postadress, fakturaadress eller besöksadress) ] }

Olika typer av adresser (addressType):

  • POPULATION_REGISTRATION_ADDRESS("Folkbokföringsadress"),

  • SEPARATE_ADDRESS("Särskild adress"),

  • FOREIGN_ADDRESS("Utländsk adress")

Olika kategorier av adresser (addressCategory):

  • POSTAL_ADDRESS("Postadress"),

  • INVOICE_ADDRESS("Fakturaadress"),

  • VISITING_ADDRESS("Besöksadress")