Tilknyt dokumentation for identitet eller adresse

Brug dette trin, når identiteten eller adressen er oprettet, og de nødvendige filer er uploadet via create_encrypt_files med den valgte dokumentationstype. Brug et aktuelt ID fra get_proof_types, som svarer til kravet og enhedskategorien.

Gem identity_id og address_id fra create_document; profilens UUID er en anden identifikator. Kompatibiliteten med senere tilknytning af adressedokumentation til nyoprettede profiler er stadig under gennemgang. Hvis adressen afvises, skal du kontrollere portalen eller kontakte support, før du prøver igen.

Opret dokumentationen

Brug en aktiveret MultiTEL API-konto og dens tilladte IP-adresse. Eksemplerne bruger legitimationsoplysninger til HTTP Basic fra miljøvariabler; følg godkendelsesreglerne for din kontotype. Send anmodninger via HTTPS. Kontrollér både HTTP-svaret og JSON-feltet status.code; applikationsfejl kan forekomme med HTTP 200. Eksemplerne nedenfor er fiktive.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

Anmodningsfelter
Felt	Betydning
`entity_type`	Brug identities eller addresses. Vælg den kategori, der svarer til både den identitet eller adresse, du vil tilknytte dokumentationen til, og de uploadede filer.
`entity_id`	ID for den identitet eller adresse, der tilhører din konto. Brug den identifikator, som din dokumentarbejdsgang returnerer; erstat den ikke med et telefonnummer eller et ID for et uvedkommende dokument.
`proof_type_id`	ID for den valgte dokumentationstype. Sørg for, at det stemmer overens med de uploadede filer og kravet.
`encrypted_file_ids`	Et ikke-tomt JSON-array med fil-ID'er returneret af create_encrypt_files. Filerne skal tilhøre samme konto, må ikke være udløbet og skal svare til enhedskategorien. Dette er ikke en liste over lokale filstier.

Formulardata accepteres også med gentagne encrypted_file_ids[]-felter. Brug helst et egentligt JSON-array eller formulararray; send ikke et JSON-kodet array som en almindelig skalarværdi i formularen.

Gem dokumentationens ID

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

Et vellykket svar bekræfter, at tilknytningen af dokumentationen er oprettet. Det bekræfter ikke, at identiteten eller adressen er godkendt, at alle landekrav er valideret, eller at et telefonnummer er aktiveret.

Fejl og udløbne uploads

API-kode 500 bruges ved manglende påkrævede input, fejl hos teleoperatøren og et ugyldigt svar fra teleoperatøren. Kode 404 bruges, når den identitet eller adresse, dokumentationen skal tilknyttes, ikke er knyttet til den aktuelle konto, dokumentationstypen er ugyldig, en uploadet fil ikke kan findes for denne konto og kategori eller er udløbet, eller der ikke er nogen brugbare fil-ID'er tilbage. Læs status.msg sammen med koden.

Upload en udløbet påkrævet fil igen med den korrekte dokumentationskategori, før du tilknytter den. Hvis blot én af de angivne filer er ugyldig, stopper denne behandlingsfunktion, før den sender anmodningen om at oprette dokumentationen. Der stilles ingen idempotensnøgle til rådighed: Efter en timeout skal du kontrollere det eksisterende dokument i portalen, før du gentager tilknytningen.