Endepunkter
Liste over alle webservice endepunkter.
På denne siden:
URI til alle Altinn tjenester / aliasoversikt for endepunkter
Web servicene beskrevet i dokumentet er angitt uten informasjon om endepunkt. En web service operasjon kan kalles med forskjellige endepunkter ut fra hvilken autentiseringsmetode tjenesteeier ønsker å benytte.
Det tilbys opp til tre forskjellige endepunkter for hver web service operasjon:
- Basic Http (SOAP 1.1). Tradisjonell interoperabel web service hvor autentiseringsinformasjonen (brukernavn/passord) ligger i meldingen.
- WS Http (SOAP 1.2 med WS-Security username token). Støtte for nye web standarder WS*, dvs. bl.a. at autentiseringsinformasjonen (brukernavn/passord) ligger i SOAP headeren.
- WS Http (SOAP 1.2 med WS-Security X.509 token) (markert som EC2). Støtte for ny web standarder WS*, dvs. bl.a. at sertifikat ligger i SOAP headeren mensbrukernavn og passord ligger i meldingen.
- WS Http (SOAP 1.2 med WS-Security X.509 token) (markert som AEC2). Støtte for ny web standarder WS*, dvs. bl.a. at sertifikat ligger i SOAP headeren. Sertifikatet må være utstedt til en organisasjon som er registrert som tjenesteeier i Altinn.
Utgåtte endepunkt Opprinnelig ble EC grenssnittene satt opp med sesjon på serversiden. Dette var sårbart for klienter som ikke stengte sine sesjoner og endte opp med at serveren til slutt brukte opp alle sine sesjoner derfor ble det laget nye grensesnitt (EC2) der sesjonen holdes av klienten. Desverre var det en del klienter som ikke klarte å bruke de nye grensesnittene derfor ble det opprettet nye grensesnitt (EC2) og ikke bare endret på de eksisterende. Da kan de som ikke kan bruke de nye få mer tid, samtidig som alle som kan går over gjør det umidelbart.
- WS Http (SOAP 1.2 med WS-Security X.509 token) (markert som EC). Støtte for ny web standarder WS*, dvs. bl.a. at sertifikat ligger i SOAP headeren mensbrukernavn og passord ligger i meldingen.
- WS Http (SOAP 1.2 med WS-Security X.509 token) (markert som AEC). Støtte for ny web standarder WS*, dvs. bl.a. at sertifikat ligger i SOAP headeren. Sertifikatet må være utstedt til en organisasjon som er registrert som tjenesteeier i Altinn.
Eksempel:
Web service operasjonen “GetReceiptV2” kan aksesseres ved å kalle endepunktet “ReceiptAgencyExternal” hvis man ønsker å bruke/autentisere vha. WS* standarden.
Samme operasjon finnes med navn “GetReceiptBasicV2” på endepunktet “ReceiptExternalBasic” hvis man ønsker tradisjonell web service aksessering.
Tilslutt finnes det en tredje versjon av operasjonen med navn GetReceiptExternalECV2 på endepunktet “ReceiptExternalEC2” hvis man ønsker å benytte virksomhetssertifikat i autentiseringen.
Her følger en aliasoversikt som viser kobling mellom operasjon og endepunkt(er) (Se også Tjenestekatalogen (Service Inventory) for informasjon om tjenesten og endepunkt):
ArchiveCommon
Receipt
CaseAgencySystem
Correspondence
AltUt
| Basis operasjon | URI/Endepunkt | Endepunkt operasjon |
|---|---|---|
| SubmitAltutMessagePw | Basic Http https://www.altinn.no/webservicesAgency/AgencydataExchange.asmx?op=SubmitAltutMessagePw | SubmitAltutMessagePw |
Prefill
| Basis operasjon | URI/Endepunkt | Endepunkt operasjon |
|---|---|---|
| SubmitAndInstantiatePrefilledFormTask | WS Http https://www.altinn.no/ServiceEngineExternal/Prefill.svc | SubmitAndInstantiatePrefilledFormTask |
| SubmitAndInstantiatePrefilledFormTask | Basic Http https://www.altinn.no/ServiceEngineExternal/PrefillBasic.svc | SubmitAndInstantiatePrefilledFormTaskBasic |
| SubmitAndInstantiatePrefilledFormTask | EC2 https://www.altinn.no/ServiceEngineExternal/PreFillAgencyExternalEC2.svc | SubmitAndInstantiatePrefilledFormTaskEC |
| SubmitAndInstantiatePrefilledFormTask | EC https://www.altinn.no/ServiceEngineExternal/PreFillAgencyExternalEC.svc | SubmitAndInstantiatePrefilledFormTaskEC |
| SubmitPrefilledFormTasks | WS Http https://www.altinn.no/ServiceEngineExternal/Prefill.svc | SubmitPrefilledFormTasks |
| SubmitPrefilledFormTasks | Basic Http https://www.altinn.no/ServiceEngineExternal/PrefillBasic.svc | SubmitPrefilledFormTasksBasic |
| SubmitPrefilledFormTasks | EC2 https://www.altinn.no/ServiceEngineExternal/PreFillAgencyExternalEC2.svc | SubmitPrefilledFormTasksEC |
| SubmitPrefilledFormTasks | EC https://www.altinn.no/ServiceEngineExternal/PreFillAgencyExternalEC.svc | SubmitPrefilledFormTasksEC |
Subscription
| Basis operasjon | URI/Endepunkt | Endepunkt operasjon |
|---|---|---|
| SubmitSubscription | WS Http https://www.altinn.no/ServiceEngineExternal/Subscription.svc | SubmitSubscription |
| SubmitSubscription | Basic Http https://www.altinn.no/ServiceEngineExternal/SubscriptionBasic.svc | SubmitSubscriptionBasic |
| SubmitSubscription | EC2 https://www.altinn.no/ServiceEngineExternal/SubscriptionAgencyExternalEC2.svc | SubmitSubscriptionEC |
| SubmitSubscription | EC https://www.altinn.no/ServiceEngineExternal/SubscriptionAgencyExternalEC.svc | SubmitSubscriptionEC |
NotificationAgencyExternal
| Basis operasjon | URI/Endepunkt | Endepunkt operasjon |
|---|---|---|
| SendStandaloneNotification | WS Http https://www.altinn.no/ServiceEngineExternal/NotificationAgencyExternal.svc | SendStandaloneNotificationV4 |
| SendStandaloneNotification | Basic Http https://www.altinn.no/ServiceEngineExternal/NotificationAgencyExternalBasic.svc | SendStandaloneNotificationBasicV4 |
| SendStandaloneNotification | EC2 https://www.altinn.no/ServiceEngineExternal/NotificationAgencyExternalEC2.svc | SendStandaloneNotificationECV4 |
| SendStandaloneNotification | EC https://www.altinn.no/ServiceEngineExternal/NotificationAgencyExternalEC.svc | SendStandaloneNotificationECV4 |
AuthorizationAdministration
| Basis operasjon | URI/Endepunkt | Endepunkt operasjon |
|---|---|---|
| GetReporteeByTempKey | WS Http https://www.altinn.no/AuthorizationExternal/AdministrationExternal.svc | GetReporteeByTempKey |
| GetReportees | WS Http https://www.altinn.no/AuthorizationExternal/AdministrationExternal.svc | GetReportees |
| GetRoles | WS Http https://www.altinn.no/AuthorizationExternal/AdministrationExternal.svc | GetRoles |
AuthorizationDecisionPointExternal
| Basis operasjon | URI/Endepunkt | Endepunkt operasjon |
|---|---|---|
| AuthorizeAccessExternal | WS Http https://www.altinn.no/AuthorizationExternal/AuthorizationDecisionPointExternal.svc | AuthorizeAccessExternal |
DownloadQueueExternal
ContextHandlerExternal
| Basis operasjon | URI/Endepunkt | Endepunkt operasjon |
|---|---|---|
| GetReporteeElementContextExternal | WS Http https://www.altinn.no/ServiceEngineExternal/ContextHandlerExternal.svc | GetReporteeElementContextExternal |
| GetReporteeElementContextExternal | Basic Http https://www.altinn.no/ServiceEngineExternal/ContextHandlerExternalBasic.svc | GetReporteeElementContextExternalBasic |
| GetReporteeElementContextExternal | EC2 https://www.altinn.no/ServiceEngineExternal/ContextHandlerEC2.svc | GetReporteeElementContextExternalEC |
| GetReporteeElementContextExternal | EC https://www.altinn.no/ServiceEngineExternal/ContextHandlerEC.svc | GetReporteeElementContextExternalEC |
RegisterSSRAgencyExternal
Alle URI er angitt med produksjonsadresse. Frem til produksjonssetting må https://www.altinn.no erstattes med peker til testmiljø.