Hente ut liste over roller
Denne siden beskriver hvordan Altinn kan brukes til å hente ut liste over roller en bruker har på vegne av andre
Hente ut roller
Hente ut alle roller en person/organisasjon {subject} har for en annen person/organisasjon {reportee} på tjenester som tilhører autentisert tjenesteeier.
GET https://www.altinn.no/api/serviceowner/authorization/roles?ForceEIAuthentication&language={language}&subject={subject}&reportee={reportee} HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"_links": {
"self": {
"href": "https://tt02.altinn.no/api/serviceowner/authorization/roles?subject=811077062&reportee=23114702129"
}
},
"_embedded": {
"roles": [
{
"RoleId": 491068,
"RoleType": "Altinn",
"RoleDefinitionId": 11,
"RoleName": "Reporter/sender",
"RoleDescription": "Access to selected forms and services",
"Delegator": "ERLING ENGENES",
"DelegatedTime": "2019-08-26T12:39:29.113",
"_links": {
"roledefinition": {
"href": "https://tt02.altinn.no/api/serviceowner/roledefinitions/11"
}
}
}
]
}
}
Hente ut alle rolledefinisjoner
GET https://www.altinn.no/api/serviceowner/roledefinitions?ForceEIAuthentication&language={language} HTTP/1.1
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions"
}
},
"_embedded": {
"roledefinitions": [
{
"RoleType": "Altinn",
"RoleDefinitionId": 1,
"RoleName": "Bankruptcy read",
"RoleDescription": "Reading rights for information in the service Konkursbehandling (bankruptcy proceedings)",
"RoleDefinitionCode": "BOBEL",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/1"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 2,
"RoleName": "Bankruptcy write",
"RoleDescription": "Writing rights for information in the service Konkursbehandling (bankruptcy proceedings)",
"RoleDefinitionCode": "BOBES",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/2"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 3,
"RoleName": "Salaries and personnel employee",
"RoleDescription": "Access to services related to salaries and personnel",
"RoleDefinitionCode": "LOPER",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/3"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 4,
"RoleName": "Access manager",
"RoleDescription": "Administration of access",
"RoleDefinitionCode": "ADMAI",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/4"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 5,
"RoleName": "Limited rights for an individual",
"RoleDescription": "Delegable rights to services for individuals",
"RoleDefinitionCode": "PRIUT",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/5"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 6,
"RoleName": "Accounting employee",
"RoleDescription": "Access to accounting related forms and services",
"RoleDefinitionCode": "REGNA",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/6"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 7,
"RoleName": "Auditor's rights",
"RoleDescription": "Delegable auditor's rights",
"RoleDefinitionCode": "REVAI",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/7"
}
}
},
{
"RoleType": "Altinn",
"RoleDefinitionId": 8,
"RoleName": "Limited signing rights",
"RoleDescription": "Signing access for selected forms and services",
"RoleDefinitionCode": "SISKD",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/8"
}
}
}
]
}
}
Hente ut én spesifikk rolledefinisjon
GET https://www.altinn.no/api/serviceowner/roledefinitions/{roleDefinitionId}?ForceEIAuthentication&language={language}
Accept: application/hal+json
ApiKey: myKey
Eksempel på respons:
{
"RoleType": "Altinn",
"RoleDefinitionId": 4,
"RoleName": "Tilgangsstyring",
"RoleDescription": "Denne rollen gir administratortilgang til å gi videre rettigheter til andre.\r\n",
"RoleDefinitionCode": "ADMAI",
"_links": {
"self": {
"href": "https://www.altinn.no/api/serviceowner/roledefinitions/4"
}
}
}