Application The Application model is the main model for metadata for the application. Name Description id A gobally unique id for the application. The value has two parts separated by a ‘/’ character. The first part is the short name of the application owner and the second part is the name of the app. versionId The current version of the application. (Currently not in use.) org The short name of the application owner. »
Overview The endpoints documented here are all for accessing metadata on the app itself and the data types that are allowed in an instance of the app. Additional endpoints provides access to text resources. Get app metadata Endpoint for downloading a copy of the application metadata document. GET {basePath}/api/v1/applicationmetadata Get Application texts Get text resources for the application for a specific language code. If the requested language isn’t available, norsk bokmål (nb) will be returned as default. »
Instance The Instance model is the main model of an instance. An instance can be regarded as an envelope or folder where data is collected and exchanged between the application user and owner. The instance document is a way for Altinn and external parties to track the state of one specific data exchange. Properties Name Description id A gobally unique id for the instance. The value has two parts separated by a ‘/’ character. »
Overview An instance can be regarded as an envelope or folder where data is collected and exchanged between the application user and owner. The instance document is a way for Altinn and external parties to track the state of one specific data exchange. How long an instance lives and how many interactions there are between the application owner and user will vary from one app to another. Advanced apps will have their own documentation. »
DataElement The data element model is the main model for metadata related to a specific data element. A data element can be any data associated with an instance. The two most common type of data is the actual form data and attachments. Properties Name Description id A globally unique id for the data element. instanceGuid The globally unique id for the instance the data element is associated with. dataType The name of the data type describing the requirements of the data element. »
Authentication for application owners Application owners should be authenticated with Maskinporten. API provisioning in Maskinporten API-provider To provide an API in maskinporten Altinn has to do two operations. As API-provider Altinn registres a scope in Maskinporten POST /scopes { "prefix": "altinn", "subscope": "instances/metadata.read", "description": "Clients can access metadata for all instances for all apps of the organisation" } As API-provider Altinn has to give access to its scope for a given organisation PUT /scopes/access/889640782? »
Overview A data element consist of two parts: its metadata document and the actual data blob. This API work primarily with the blob while keeping the metadata document updated. basePath {org}/{appname}/instances/{instanceOwnerPartyId}/{instanceGuid}/data Get data Endpoint for downloading the data blob. GET basePath/{dataGuid} Accept: application/{xml/json} The response will depend on the type of blob. There are currently 2 primary types: form data based on a model and attachments. An Accept header in a request will be considered only when the requested data element is connected to a data model. »
Overview An instance works as a form of envelope or folder where data can be collected and exchanged between the user and owner of the application. The instance document is a way for Altinn and external parties to track the state of one specific data exchange. How long an instance can live and how many interactions there can be between the application owner and user will vary from one app to another. »
Overview Your organization needs the scope altinn:resourceregistry/resource.write to be allowed to create and modify your organizations resources and policies. The resource describes the different metadata for a resource { "identifier":"brg_samordnet_registermelding", "description": [ { "language": "nb-NO", "description": "Elektronisk skjema for registrering av selskap" }, { "language": "EN", "description": "Registering a new entity or changing information regarding an existing entity" } ], "title": [{ "title":"Samordnet registermelding", "language":"nb-NO" }, { "title":"Coordinated register notification", "language":"en" }], "hasCompetentAuthority": { "organization": "974760673", "orgcode":"brg" }, "contactpoint": [{ "phone":"1231324", "email": "online@digdir. »
Oversikt API’et for tags (stikkord) på data elementer har endepunkter for å liste ut tags, legge til en tag, samt sletting av tag. baseSti {org}/{appname}/instances/{instanceOwnerPartyId}/{instanceGuid}/data/{dataGuid}/ Hent tags Endepunkt for å laste ned listen med tags som allerede er lagt til på et data element. GET baseSti/tags Accept: application/json Legge til tag Endepunkt for å legge til en ny tag. POST baseSti/tags Content-Type: application/json "bokstaver" API kallet må inneholde det nye ordet i anførselstegn. »
