Bifoga ett identitets- eller adressbevis

Använd det här steget när identiteten eller adressen har skapats och dess obligatoriska filer har laddats upp via create_encrypt_files med den valda bevistypen. Använd ett aktuellt ID från get_proof_types, som motsvarar kravet och entitetskategorin.

Spara identity_id och address_id från create_document; profilens UUID är en annan identifierare. Kompatibiliteten för att i efterhand bifoga adressbevis till nyskapade profiler granskas fortfarande. Om adressen avvisas ska du kontrollera portalen eller kontakta supporten innan du försöker igen.

Skapa beviset

Använd ett aktiverat MultiTEL API-konto och den IP-adress som är tillåten för kontot. Exemplen använder inloggningsuppgifter för HTTP Basic från miljövariabler; följ autentiseringsrutinerna för din kontotyp. Skicka anrop via HTTPS. Kontrollera både HTTP-svaret och följande fält i JSON: status.code; applikationsfel kan förekomma även vid HTTP 200. Exemplen nedan är fiktiva.

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"
  ]
}

Fält i anropet
Fält	Betydelse
`entity_type`	Använd identities eller addresses. Välj den kategori som motsvarar både målobjektet och de uppladdade filerna.
`entity_id`	ID för den identitet eller adress som tillhör ditt konto. Använd identifieraren som returneras av ditt dokumentarbetsflöde; ersätt den inte med ett telefonnummer eller ett orelaterat dokument-ID.
`proof_type_id`	ID för den valda bevistypen. Se till att det stämmer överens med uppladdningen och kravet.
`encrypted_file_ids`	En JSON-array som inte är tom och som innehåller fil-ID:n som returnerats av create_encrypt_files. Filerna måste tillhöra samma konto, fortfarande vara giltiga och motsvara entitetskategorin. Detta är inte en lista över lokala filsökvägar.

Formulärdata accepteras också med upprepade encrypted_file_ids[]-fält. Använd helst en riktig JSON-array eller en formulärarray; skicka inte en JSON-kodad array som ett vanligt skalärt formulärvärde.

Spara bevisets 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"
  }
}

Ett lyckat svar bekräftar att kopplingen till beviset har skapats. Det bekräftar inte att identiteten eller adressen har godkänts, att alla landspecifika krav har validerats eller att ett telefonnummer har aktiverats.

Fel och uppladdningar vars giltighetstid har löpt ut

API-kod 500 används när obligatoriska indata saknas, vid operatörsfel och vid ett ogiltigt svar från operatören. Kod 404 används när målobjektet inte är kopplat till det aktuella kontot, bevistypen är ogiltig, en uppladdad fil inte kan hittas för detta konto och denna kategori eller har upphört att gälla, eller när inga användbara fil-ID:n återstår. Läs status.msg tillsammans med koden.

Ladda upp en obligatorisk fil vars giltighetstid har löpt ut på nytt med rätt beviskategori innan du bifogar den. Om någon av de angivna filerna är ogiltig avbryter hanteraren innan anropet för att skapa beviset skickas. Ingen idempotensnyckel tillhandahålls: efter en timeout ska du kontrollera det befintliga dokumentet i portalen innan du upprepar bifogandet.