Identifiser mottaker

Identifiser mottaker benyttes typisk når man har behov for å sjekke om én spesifikk person er en Digipost bruker. Dette kan være nyttig både i forkant av en utsendelse og i en prosess hvor egen kundedatabase oppdateres med Digipost-adresser. Man kan identifisere en mottaker ved hjelp av fødselsnummer, Digipost-adresse eller navn og gateadresse.

Identify recipient should be used if you need to just check if one specific person is a Digipost user. This can be useful both prior to sending digital mail and as part of a process where (for example) a customer database is being updated with Digipost-addresses. You can identify a person by personal identification number (fødselsnummer), Digipost-address or name and street address.

Endepunkt

Endpoint

https://api.digipost.no/identification

Verb

http post

Request

<?xml version="1.0" encoding="utf-8"?>
<identification xmlns="http://api.digipost.no/schema/v7" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <personal-identification-number>01013300001</personal-identification-number>
</identification>

  

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<identification-result xmlns="http://api.digipost.no/schema/v7">
    <result>DIGIPOST</result>
</identification-result>
  

Kommentarer

Additional comments

• Du kan være sikker på at responsen inneholder den samme person som ble sendt inn i requesten.
• Se XSD-en for hvordan en mottaker kan identifiseres basert på Digipost-adresse eller navn og gateadresse.
• Responsen kan inkludere følgende resultater:
  • DIGIPOST
    Mottaker er identifisert og er Digipost-bruker.
  • IDENTIFIED
    Mottaker er identifisert, men er ikke Digipost-bruker. Person-alias returneres som kan benyttes ved senere identifisering.
  • UNIDENTIFIED
    Det var ikke mulig å identifisere mottakeren basert på data som var inkludert i requesten.

• You can be sure that the Digipost user returned in the response is the same person as was specified in the request.
• The xsd includes details on how a person can be identified by either Digipost-address or name and street address.
• The response can include the following results:
  • DIGIPOST
    The person is a Digipost user.
  • IDENTIFIED
    The person was identified, but is not a Digipost user. The returned person-alias can be used in later identification.
  • UIDENTIFIED
    Digipost was not able to identify the person based on the information included in the request.