Forskjell i bruk mellom eksisterende Altinn 2 REST-operasjoner og Altinn 2 REST-operasjoner som har overføres til Altinn 3. For standard bruk av Altinn 2 REST-operasjoner, se [Altinn Docs] (https://Altinn.github.io/docs/api/rest/formidling/)
For alle tjenester som går til Altinn 3 via overgangsløsning vil kvitteringer bli generert basert å Altinn 3 fil metadata. Dette betyr at alle kvitteringer som returneres vil være pseudo-kvitteringer, og alle kvitteringsid vil være 0.
Hvis brukssaken din krever bruk av kvittering, kan du sende inn en endringsforespørsel. »
Disse sidene beskriver forskjell i bruk av Altinn 2 Formidlings-tjeneste endepunkter når de brukes for Altinn 2 Formidlings-tjenester og når de brukes for Formidlings-tjenester overført til Altinn 3 ressurs ved bruk av overgangsløsningen.
Brukerveiledning RESTForskjell i bruk av REST-operasjoner mellom Altinn 2 og Altinn 3 overførte tjenester.
Bruksanvisning SOAPForskjell i bruk av SOAP kall mellom Altinn 2 og Altinn 3 overførte tjenester. »
Forskjell i bruk mellom eksisterende Altinn 2 SOAP operasjoner og Altinn 3 SOAP operasjoner som er overført til Altinn 3. SOAP operasjoner for Altinn 2 Formidlingstjeneste er spredt over 3 endepunkter. For de fleste forespørsler vil det ikke være noen funksjonell forskjell mellom Altinn 2 og Altinn 3 forespørsler.
Service Endpoint Description BrokerService Service WS Behandler metadata requester. Service Basic Service EC BrokerService Streamed Streamed WS Behandler fil data requester. Streamed Basic Streamed EC Receipt Receipt WS Behandler receipt requester. »
Tjenesteeiere For å bruke Formidling overgangsløsningen i Altinn 2 for å opprette, laste opp og hente fil metadata, må en tjenesteeier fullføre følgende trinn.
Ha en eksisterende Altinn 2 Formidlingstjeneste. Ha eller lag en tilsvarende Altinn 3 Formidlings-ressurs. Se hvordan du kommer i gang med Altinn 3 Formidling her. Be om et overgangsoppsett fra Altinn 2 tjenesten til Altinn 3 ressursen. Bestem dato for når dette skal gå i live. (For å minimere risiko for foreldreløse data i Altinn 2 lagring) Gå live med overgangsløsning mens du oppfordrer forbrukerne til å migrere til Altinn Formidling. »
Dette avsnittet av dokumentasjonen er under arbeid. Det er deler som mangler eller bare delvis er dokumentert. Noen funksjoner representerer ikke den endelige produksjonsversjonen. Dette er felles steg som alle roller (tjenesteeier, avsendere og mottakere) må gjennomføre for å begynne å bruke Altinn Broker-komponenten.
1. Skaff deg en Altinn API-nøkkel For å bruke noen Altinn-API-er trenger du en abonnementsnøkkel for API-ene. Denne sendes som headeren Ocp-Apim-Subscription-Key i hvert forespørsel. »
Dette avsnittet av dokumentasjonen er under utvikling, og inneholder derfor omfattende referanser til eksterne kilder. Her er de detaljerte API-operasjonene og hendelsene du vil bruke når du sender filer.
Se også vår swagger-side.
Operasjon: Initialiser Filoverføring Endepunkt: POST /broker/api/v1/filetransfer/
Denne operasjonen initialiserer en filoverføring, inkludert validering av grunnleggende metadata og autorisasjon hvis mottaker(e) spesifisert er gyldige.
Forespørsel: En instans av FileInitializeExt serialisert som JSON.
Return: HTTP 200 med GUID-en FileTransferID som er den unike ID-en brukt til å identifisere denne filoverføringen. »
Denne delen av dokumentasjonen er under arbeid, og refererer derfor i stor grad til eksterne kilder. Operasjon: Hent filoverføringer Endepunkt: GET /broker/api/v1/filetransfer/(filtre)
Lar deg søke etter filoverføringer i henhold til angitte filtre, og returnerer en liste over FileTransferIds som matcher søkekriteriene. Du kan deretter bruke disse ID-ene til å hente filoverføringsoversikt og laste ned.
Denne operasjonen bør brukes sparsomt, da man bør fokusere på webhook/event/hendelse published for å varsle deg om filoverføringer som blir tilgjengeligjort til deg. »
Denne prosessen vil forenkles gjennom en fremtidig oppdatering i Altinn Studio.
Spesielt vil trinn 4-6 utføres via GUI i stedet for å kreve direkte API-kall.
1. Kom i gang som tjenesteeier i Altinn For å komme i gang med Altinn Broker må bedriften din være registrert som en tjenesteeier i Altinn. For en trinnvis veiledning, se Kom i gang med Altinn-guiden.
Dette trinnet er bare nødvendig for nye bedrifter som ennå ikke har etablert seg som tjenesteeiere på Altinn-plattformen. »
Altinn 3 Formidling Utviklerguide for AvsenderHvordan komme i gang med å sende filer med Altinn 3 Formidling, for utviklere
Altinn 3 Formidling utviklerveiledningHvordan motta filer via Altinn Formidling
Altinn 3 Formidling - Utviklerveiledning for TjenesteeierHvordan komme i gang med Altinn 3 Broker Tjenesteeier API-operasjoner, for utviklere
Altinn 3 Formidling UtviklerguiderHvordan komme i gang med å abonnere på hendelser fra Altinn 3 Broker, for utviklere
Denne delen av dokumentasjonen er under arbeid. »
Denne delen av dokumentasjonen er under arbeid, og inneholder derfor omfattende referanser til eksterne kilder, samt beskrivelser av flere scenarier. Operasjon: Initialiser Tjenesteeier i Broker API Endepunkt: POST /broker/api/v1/serviceowner
Denne operasjonen konfigurerer organisasjonen din som en Tjenesteeier i Broker Config Store.
Forespørsel: En forekomst av ServiceOwnerInitializeExt serialisert som JSON.
Retur: HTTP 200
Utløste hendelser: ingen.
Eksempel: “Register Service Owner” i vår PostMan-samling.
Operasjon: Hent Tjenesteeierkonfigurasjon fra Broker API Endepunkt: GET /broker/api/v1/serviceowner »
