Legg ved dokumentasjon på identitet eller adresse

Utfør dette trinnet etter at identiteten eller adressen er opprettet, og etter at de nødvendige filene er lastet opp via create_encrypt_files med den valgte dokumentasjonstypen. Bruk en gjeldende ID fra get_proof_types, som samsvarer med kravet og enhetskategorien.

Ta vare på identity_id og address_id fra create_document; profilens UUID er en annen identifikator. Det vurderes fortsatt om nyopprettede profiler støtter at adressedokumentasjon legges ved senere. Hvis adressen avvises, må du sjekke portalen eller kontakte brukerstøtte før du prøver igjen.

Opprett dokumentasjonen

Bruk en aktivert konto for MultiTEL API og IP-adressen som er tillatt for kontoen. Eksemplene bruker påloggingsinformasjon for HTTP Basic fra miljøvariabler; følg autentiseringsreglene for kontotypen din. Send forespørsler over HTTPS. Kontroller både svaret fra HTTP og verdien i JSON-feltet status.code; applikasjonsfeil kan returneres med HTTP 200. Eksemplene 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"
  ]
}

Felt i forespørselen
Felt	Betydning
`entity_type`	Bruk identities eller addresses. Velg kategorien som samsvarer med både målenheten og de opplastede filene.
`entity_id`	ID-en til identiteten eller adressen som tilhører kontoen din. Bruk identifikatoren som returneres i dokumentarbeidsflyten din; ikke erstatt den med et telefonnummer eller ID-en til et uvedkommende dokument.
`proof_type_id`	ID-en til den valgte dokumentasjonstypen. Den må samsvare med opplastingen og kravet.
`encrypted_file_ids`	En ikke-tom JSON-tabell med fil-ID-er returnert av create_encrypt_files. Filene må tilhøre samme konto, ikke ha utløpt og samsvare med enhetskategorien. Dette er ikke en liste over lokale filbaner.

Skjemadata godtas også med gjentatte encrypted_file_ids[]-felt. Bruk helst en faktisk JSON-tabell eller en skjematabell; ikke send en tabell kodet som JSON som en vanlig skalarverdi i skjemaet.

Ta vare på dokumentasjonens 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 bekrefter at koblingen til dokumentasjonen er opprettet. Det bekrefter ikke godkjenning av identiteten eller adressen, validering av alle krav for landet eller aktivering av et telefonnummer.

Feil og utløpte opplastinger

API-kode 500 brukes ved manglende obligatoriske inndata, feil hos operatøren og ugyldig svar fra operatøren. Kode 404 brukes når målenheten ikke er knyttet til den gjeldende kontoen, dokumentasjonstypen er ugyldig, en opplastet fil ikke finnes for denne kontoen og kategorien eller har utløpt, eller ingen brukbare fil-ID-er gjenstår. Les status.msg sammen med koden.

Last opp en utløpt obligatorisk fil på nytt med riktig dokumentasjonskategori før du legger den ved. Hvis en av de innsendte filene er ugyldig, stopper denne behandlingsfunksjonen før forespørselen om å opprette dokumentasjonen sendes. Ingen idempotensnøkkel er tilgjengelig: etter et tidsavbrudd må du kontrollere det eksisterende dokumentet i portalen før du gjentar vedleggingen.