Bokmål English
Registrer deg Register
Språk    Language    Bokmål English Tjenester privat Tenester privat Private Tjenester bedrift Tenester verksemd Business Digipost Labs Hjelp Help Hjelp Help
For partnere For partnarar For partners For utviklere For utviklarar For developers Sikkerhet Sikkerheit Security Vilkår Terms
Du må oppgradere nettleseren din for å bruke Digipost. Les mer her.

Kom i gang med API-et til Digipost på 1-2-3

Det er veldig enkelt å integrere med Digipost og sende ditt første brev. Vi foreslår at du benytter et av våre klientbiblioteker for å komme raskt igang. Følgende tre steg er alt som må til:

1

Registrer deg for sending i Digipost

Alle virksomheter som ønsker å sende brev i Digipost må ha en virksomhetskonto. Du kan få tilgang til en test-konto ved å sende en e-post til support@digipost.no med følgende informasjon:

  • Navn på virksomheten
  • Organisasjonsnummer
  • Telefonnummer
  • E-postadresse
  • Digipostadressene til de som skal ha tilgang
2

Ta i bruk Digipost klientbibliotek for ditt språk

Ta i bruk klientbiblioteket for enten Java eller .NET slik at du kan enkelt integrere med Digipost som avsender. Du kan selvsagt også gjøre en manuell integrasjon mot selve APIet, men vi anbefaler at du benytter våre klientbibliotek.

Java klientbibliotek .NET klientbibliotek
3

Bruk Digipost klientbiblioteket fra din kode

Det er ikke mange kodelinjer som skal til for å sende brev. Koden nedenfor viser hva som skal til for å sende et brev. Det er naturlig nok mange flere muligheter i klientbibliotekene og APIene til Digipost, men dette er en enkel introduksjon som lar deg sende et standard brev til én mottaker i Digipost.


// 1. Initialiser konfig med din Digipost avsender id
// Avsender id finner du på digipost.no/bedrift
var config = new ClientConfig(senderId: "xxxxx", environment: Environment.Production);

// 2. Initialiser klient med thumbprint til sertifikat som er knyttet til din Digipost virksomhetskonto 
// Virksomhetssertifikat knyttes til din Digipost konto på digipost.no/bedrift.
// Informasjon om bruk av thumbprints finnes på http://digipost.github.io/digipost-api-client-dotnet/#installcert.
var client = new DigipostClient(config, thumbprint: "84e492a972b7e...");

// 3. Lag melding med bruk av fødselsnummer som personidentifikator
var message = new Message(
    new RecipientById(IdentificationType.PersonalIdentificationNumber, "00000000000"),
    new Document(subject: "Dokumentets emne", fileType: "pdf", path: @"c:\...\dokument.pdf")
);

// 4. Send melding
var result = client.SendMessage(message);

                        
// 1. Les inn sertifikatet du har knyttet til din Digipost-konto (i .p12-formatet)
InputStream sertifikatInputStream = new FileInputStream("certificate.p12");

// 2. Opprett en DigipostClient
DigipostClient client = new DigipostClient(DigipostClientConfigBuilder.newBuilder().build(), ATOMIC_REST, "https://api.digipost.no", AVSENDERS_KONTOID, sertifikatInputStream, SERTIFIKAT_PASSORD);

// 3. Opprett et fødselsnummerobjekt
PersonalIdentificationNumber pin = new PersonalIdentificationNumber("26079833787");

// 4. Opprett hoveddokumentet
Document primaryDocument = new Document(UUID1, "Dokumentets emne", PDF);

// 5. Opprett en forsendelse
Message message = newMessage(UUID2, primaryDocument)
    .personalIdentificationNumber(pin)
    .build();

// 6. Legg til innhold og send
client.createMessage(message)
    .addContent(primaryDocument, new FileInputStream("content.pdf"))
    .send();
                        

Veien videre

Når du har gjort en testintegrasjon, så er veien videre å gjøre en full integrasjon i dine systemer. Les vår guide til integrasjonsprosessen for få en bedre oversikt over hvilke steg du bør ta på veien mot en Digipost-integrasjon.

Har du noen spørsmål, så finner du svar på ofte stilte spørsmål her. Du kan også kontakte oss dersom du har noen spørsmål til integrasjon.

Er du en offentlig virksomhet som søker informasjon om Sikker Digital Post, finner du dette på Difis informasjonssider.

Get started with Digipost in 1-2-3

It is really easy to integrate with Digipost and send your first digital mail. Vi suggest you use one of our client libraries to get started. Follow these three simple steps:

1

Get registered as a Digipost sender

All organisations that wish to send digital mail must have a Digipost organisation (sender) account. To get a test account, send an email to support@digipost.no with the following information:

  • Organisastion name
  • Organisation number
  • Telephone number
  • Email address
  • The Digipost addresses of the people who should have access
2

Choose between the Java or .NET Digipost client libraries

Use the Digipost client library in either Java or .NET to send requests to the Digipost API. You can also integrate directly with the API, but we recommend using a client library.

Java client library .NET client library
3

Call Digipost client library code from your code

All it takes is a few lines of code to send digital mail. The following code shows a bare bones example of how to do this. There are many other options and possibilities in the client libraries and Digipost API, but the below is quick introduction to how sending a letter to a Digipost recipient works.


// 1. Initialise config with your Digipost sender id
// You can find your sender id at digipost.no/bedrift
var config = new ClientConfig(senderId: "xxxxx");

// 2. Initialise client with your certificates thumbprint which is connected to your Digipost organisation account
// You can upload your certificate at digipost.no/bedrift.
// See http://digipost.github.io/digipost-api-client-dotnet/#installcert for further information on thumbprints
var client = new DigipostClient(config, thumbprint: "84e492a972b7e...");

// 3. Create message by using personal identification number as identification mechanism
var message = new Message(
    new Recipient(IdentificationChoice.PersonalidentificationNumber, "311084xxxx"),
    new Document(subject: "Dokumentets emne", mimeType: "pdf", path: @"c:\...\dokument.pdf")
  );

// 4. Send message
var result = client.SendMessage(message);

                        
// 1. Read the certificate that is tied to your Digipost organisation account (in .p12 format)
InputStream sertifikatInputStream = new FileInputStream("certificate.p12");

// 2. Create a DigipostClient
DigipostClient client = new DigipostClient(STEPWISE_REST, "https://api.digipost.no", AVSENDERS_KONTOID, sertifikatInputStream, SERTIFIKAT_PASSORD);

// 3. Create a personal identification number object
PersonalIdentificationNumber pin = new PersonalIdentificationNumber("26079833787");

// 4. Create primary document object
Document primaryDocument = new Document(UUID1, "Dokumentets emne", PDF);

// 5. Create message object
Message message = newMessage(UUID2, primaryDocument)
    .personalIdentificationNumber(pin)
    .build();

// 6. Add content to message and send message
client.createMessage(message)
    .addContent(primaryDocument, new FileInputStream("content.pdf")
    .send();
                        

Next steps

Now that you have completed a test integration, the next step is to implement the full integration in your application or system. Read our guide to integration (in Norwegian) to see which steps are typically involved in implementing a production-ready integration with Digipost.

For additional questions you may have, see our FAQ. You can also contact Digipost regarding integration questions.

If your organisation is considered public sector and you are looking for information about Difi's digital mail program, see Difi's web pages on this topic.