Sist endret: 17. okt. 2025

Klient delegering

API for å håndtere kunder for et agentsystem

Klientdelegerings-API

Klientdelegerings-API-et tilbyr metoder for å administrere klienter for en agentsystembruker fra et tredjepartssystem.

Guide til å gjøre dette som sluttbruker: Klientdelegering

Sikkerhetsoppsett

API-et krever autentisering med et Bearer-token, som i dette tilfellet er et ID-porten-token med spesifikke scopes. Tokenet må veksles inn i et Altinn-token ved å bruke endepunktet /GET authentication/api/v1/exchange/id-porten. For testmiljø, legg til query-parameteren ?test=true.

API Methods

List alle agent-systembrukere for organisasjon

Returnerer en liste over alle agentbrukere i systemet som er knyttet til organisasjon

Endepunkt

GET authentication/api/v1/enduser/systemuser/agents

Scopes

Idporten token utvekslet som altinn token med scope altinn:clientdelegations.read

Innholdstype

application/json

Query parametere

party

orgnummer til eier systembruker

Eksempel på forespørsel

{{environmenturl}}/authentication/api/v1/enduser/systemuser/agents?party=314250052

Eksempel på respons

[
    {
        "id": "6af73152-3304-47d6-b418-01cf7f3cdfd5",
        "integrationTitle": "Playwright-e2e-revisor-1750059427693-0.5132620954683862",
        "systemId": "310547891_Playwright-e2e-revisor-1750059427693-0.5132620954683862",
        "productName": "",
        "systemInternalId": "e7229409-d999-4103-ba4b-b2704b8ce70c",
        "partyId": "51117759",
        "partyUuId": "",
        "reporteeOrgNo": "314250052",
        "created": "2025-06-16T07:37:11.895306Z",
        "isDeleted": false,
        "supplierName": "",
        "supplierOrgno": "310547891",
        "externalRef": "0.2gfn08aq3661750059428187",
        "accessPackages": [
            {
                "urn": "urn:altinn:accesspackage:ansvarlig-revisor"
            }
        ],
        "userType": "agent"
    },
    {
        "id": "2bab4e06-1ae8-4037-9d59-9b31250b4da8",
        "integrationTitle": "Playwright-e2e-regnskapsfoerer-1750059436258-0.04049319303233756",
        "systemId": "310547891_Playwright-e2e-regnskapsfoerer-1750059436258-0.04049319303233756",
        "productName": "",
        "systemInternalId": "f3196b16-176c-4b28-a62c-906fdcc542a0",
        "partyId": "51117759",
        "partyUuId": "",
        "reporteeOrgNo": "314250052",
        "created": "2025-06-16T07:37:17.563908Z",
        "isDeleted": false,
        "supplierName": "",
        "supplierOrgno": "310547891",
        "externalRef": "0.3sn2wdnna2z1750059436420",
        "accessPackages": [
            {
                "urn": "urn:altinn:accesspackage:regnskapsforer-lonn"
            }
        ],
        "userType": "agent"
    }
]

List alle tilgjengelige klienter for systembrukeren

Viser alle potensielle klienter for partiet som har tilgang til tilgangspakken for systembrukeren

Endepunkt

GET authentication/api/v1/enduser/systemuser/clients/available

Scopes

Idporten token utvekslet som altinn token med scope altinn:clientdelegations.read

Innholdstype

application/json

Query parametere

agent

Den unike identifikatoren til agent-systembrukeren

Paginering

API-et har foreløpig ikke støtte for paginering, men dette planlegges implementert i en senere versjon. Vi har nå lagt grunnlaget for paginering i systemet.

Eksempel på forespørsel

{{environmenturl}}/authentication/api/v1/enduser/systemuser/clients/available?agent=1b6cea43-f499-4aae-a633-51cf542795af

Eksempel på respons

{
    "links": {},
    "systemUserInformation": {
        "systemUserId": "1b6cea43-f499-4aae-a633-51cf542795af",
        "systemUserOwnerOrg": "314250052"
    },
    "data": [
        {
            "clientId": "fffefbe8-72ed-4729-b80b-dc16a96f4d9f",
            "clientOrganizationNumber": "310609544",
            "clientOrganizationName": "AUTORISERT VEIK TIGER AS"
        },
        {
            "clientId": "f9475c0b-2ee4-4a41-b306-f428f00ec21f",
            "clientOrganizationNumber": "313872076",
            "clientOrganizationName": "TØFF SITRONGUL TIGER AS"
        },
        {
            "clientId": "f909a031-5a6b-4cd7-910d-7f71bdba51d5",
            "clientOrganizationNumber": "310599298",
            "clientOrganizationName": "SPESIFIKK OPPSTEMT TIGER AS"
        },
    ]
}

List alle delegerte klienter for systembrukeren

Viser alle de delegerte klientene for systembrukeren

Endepunkt

GET authentication/api/v1/enduser/systemuser/clients/

Scopes

Idporten token utvekslet som altinn token med scope altinn:clientdelegations.read

Innholdstype

application/json

Query parametere

agent

Den unike identifikatoren til agent-systembrukeren

Paginering

API-et har foreløpig ikke støtte for paginering, men dette planlegges implementert i en senere versjon. Vi har nå lagt grunnlaget for paginering i systemet.

Eksempel på forespørsel

{{environmenturl}}/authentication/api/v1/enduser/systemuser/clients/?agent=d06fe261-c46b-4d8b-b54d-b87aa6711f4c

Eksempel på respons

{
    "links": {},
    "systemUserInformation": {
        "systemUserId": "d06fe261-c46b-4d8b-b54d-b87aa6711f4c",
        "systemUserOwnerOrg": "314250052"
    },
    "data": [
        {
            "clientId": "cdc9c5ef-caff-4617-b4da-30f405ed373a",
            "clientOrganizationNumber": "313169960",
            "clientOrganizationName": "LILLA BLØT TIGER AS"
        }
    ]
}

Deleger en klient til systembrukeren

Delegerer en klient til systembrukeren

Endepunkt

POST authentication/api/v1/enduser/systemuser/clients/

Scopes

Idporten token utvekslet som altinn token med scope altinn:clientdelegations.read altinn:clientdelegations.write

Innholdstype

application/json

Query parametere

agent

Den unike identifikatoren til agent-systembrukeren

client

Den unike identifikatoren til klienten som skal legges til systembrukeren

Eksempel på forespørsel

{{environmenturl}}/authentication/api/v1/enduser/systemuser/clients/?agent=58cd5a57-ea49-4d04-bf7d-d48b338c68db&client=ff254c60-d02a-4ae8-bcd1-34cce38a823a

Eksempel på respons

{
    "agent": "58cd5a57-ea49-4d04-bf7d-d48b338c68db",
    "client": "ff254c60-d02a-4ae8-bcd1-34cce38a823a"
}

Fjern en klient fra systembrukeren

Fjerner en klient fra systembrukeren

Endepunkt

DELETE authentication/api/v1/enduser/systemuser/clients/

Scopes

Idporten token utvekslet som altinn token med scope altinn:clientdelegations.read altinn:clientdelegations.write

Innholdstype

application/json

Query parametere

agent

Den unike identifikatoren til agent-systembrukeren

client

Den unike identifikatoren til klienten som skal fjernes fra systembrukeren

Eksempel på forespørsel

{{environmenturl}}/authentication/api/v1/enduser/systemuser/clients/?agent=58cd5a57-ea49-4d04-bf7d-d48b338c68db&client=ff254c60-d02a-4ae8-bcd1-34cce38a823a

Eksempel på respons

{
    "agent": "58cd5a57-ea49-4d04-bf7d-d48b338c68db",
    "client": "ff254c60-d02a-4ae8-bcd1-34cce38a823a"
}