Skip to content

Latest commit

 

History

History
150 lines (124 loc) · 5.32 KB

File metadata and controls

150 lines (124 loc) · 5.32 KB
title linktitle description toc tags
API test org
Org
When running the applications locally along with the local test platform one can test the APIs the application exposes.
true
translate-to-english

Appen har en rekke API som kan benyttes av applikasjonseier/tjenesteeier. Beskrivelsen du finner her er laget for Postman hvor det er benyttet testapplikasjonen MVA testapp.

Postman-prosjektet kan lastes ned fra her (høyreklikk og velg "save as").

Autentisering av tjenesteier org

I testmiljø og produksjon brukes maskinporten for å autentisere organisasjoner som eier apper.

Testplattformen for lokal testing tilbyr et enkelt api for å autentisere organisjonen som er ansvarlig.

Man trenger bare å oppgi tjenesteeier kode (som f.eks brg, skd osv)

Url: http://local.altinn.cloud/Home/GetTestOrgToken/ttd (ttd needs to be replaced with the org you want to authenticate)

The response is a JWT token that should be uses as a Authorization header.

Login

Multipart instansiering

Applikasjonene støtter at man instansierer instanser til aktører. Personer eller organsiasjoner.

Url: http://local.altinn.cloud/ttd/mva/instances

Metode: POST

Headers:

  • Authorization: Bearer + jwttoken
  • Content-Type: multipart/form-data; boundary="abcdefg"

headers

Eksempel Body:

--abcdefg
Content-Type: application/json; charset=utf-8
Content-Disposition: form-data; name="instance"

{
    "instanceOwner": {
    	"organisationNumber" : "897069650"
    }
}

--abcdefg
Content-Type: application/xml
Content-Disposition: form-data; name="RF0002"

<?xml version="1.0"?>
<Skjema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" skjemanummer="212" spesifikasjonsnummer="10420" blankettnummer="RF-0002" tittel="Alminnelig omsetningsoppgave" gruppeid="20">
	<GenerellInformasjon-grp-2581 gruppeid="2581">
		<Avgiftspliktig-grp-50 gruppeid="50">
			<RapporteringsenhetNavn-datadef-21771 orid="21771">DDG Fitness</RapporteringsenhetNavn-datadef-21771>
			<RapporteringsenhetAdresse-datadef-21773 orid="21773">Sofies Gate 1</RapporteringsenhetAdresse-datadef-21773>
			<RapporteringsenhetPostnummer-datadef-21774 orid="21774">0170</RapporteringsenhetPostnummer-datadef-21774>
            <RapporteringsenhetPoststed-datadef-21775 orid="21775">By</RapporteringsenhetPoststed-datadef-21775>
            <RapporteringsenhetOrganisasjonsnummer-datadef-21772 orid="21772">897069650</RapporteringsenhetOrganisasjonsnummer-datadef-21772>
        </Avgiftspliktig-grp-50>
    </GenerellInformasjon-grp-2581>
</Skjema>

--abcdefg--

Example Response

The below response show how an instance was created for a given organization.

{
    "id": "500000/b4a42747-882f-47fa-bcd3-94029fdbc918",
    "instanceOwner": {
        "partyId": "500000",
        "personNumber": null,
        "organisationNumber": "897069650"
    },
    "appId": "ttd/mva",
    "org": "ttd",
    "selfLinks": {
        "apps": "https://local.altinn.cloud/ttd/mva/instances/500000/b4a42747-882f-47fa-bcd3-94029fdbc918",
        "platform": "https://localhost:5101/storage/api/v1/instances/500000/b4a42747-882f-47fa-bcd3-94029fdbc918"
    },
    "dueBefore": null,
    "visibleAfter": null,
    "title": {
        "nb": "RF-0002"
    },
    "process": {
        "started": "2020-01-24T06:37:48.6026647Z",
        "startEvent": "StartEvent_1",
        "currentTask": {
            "flow": 2,
            "started": "2020-01-24T06:37:48.6027116Z",
            "elementId": "Task_1",
            "name": "Utfylling",
            "altinnTaskType": "data",
            "ended": null,
            "validated": null
        },
        "ended": null,
        "endEvent": null
    },
    "status": null,
    "appOwner": {
        "labels": null,
        "messages": null,
        "canBeDeletedAfter": null
    },
    "data": [
        {
            "id": "54d868aa-5bc9-47fb-9525-67ba4c2e595c",
            "instanceGuid": "b4a42747-882f-47fa-bcd3-94029fdbc918",
            "dataType": "RF0002",
            "filename": null,
            "contentType": "application/xml",
            "blobStoragePath": "ttd/mva/b4a42747-882f-47fa-bcd3-94029fdbc918/data/54d868aa-5bc9-47fb-9525-67ba4c2e595c",
            "selfLinks": {
                "apps": "https://local.altinn.cloud/ttd/mva/instances/500000/b4a42747-882f-47fa-bcd3-94029fdbc918/data/54d868aa-5bc9-47fb-9525-67ba4c2e595c",
                "platform": "https://localhost:5101/storage/api/v1/instances/500000/b4a42747-882f-47fa-bcd3-94029fdbc918/data/54d868aa-5bc9-47fb-9525-67ba4c2e595c"
            },
            "size": 1009,
            "locked": false,
            "refs": [],
            "created": "2020-01-24T06:37:48.641997Z",
            "createdBy": null,
            "lastChanged": "2020-01-24T06:37:48.641997Z",
            "lastChangedBy": null
        }
    ],
    "created": "2020-01-24T06:37:48.6068671Z",
    "createdBy": null,
    "lastChanged": "2020-01-24T06:37:48.6068671Z",
    "lastChangedBy": null
}