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
Email address

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.

https://www.nuget.org/packages?q=digipost-api-client

http://search.maven.org/#search%7Cga%7C1%7Cdigipost-api-client-java

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", environment: Environment.Production);

// 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 RecipientById(IdentificationType.PersonalIdentificationNumber, "00000000000"),
        new Document(subject: "Dokumentets emne", fileType: "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(DigipostClientConfigBuilder.newBuilder().build(), ATOMIC_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();