Identitäts- oder Adressnachweis zuordnen

Führen Sie diesen Schritt aus, nachdem die Identität oder Adresse angelegt wurde und Sie die dafür erforderlichen Dateien über create_encrypt_files mit dem ausgewählten Nachweistyp hochgeladen haben. Verwenden Sie eine aktuelle Kennung aus get_proof_types, die zur Anforderung und zur Kategorie der Entität passt.

Bewahren Sie identity_id und address_id aus create_document auf; die UUID des Profils ist eine andere Kennung. Ob neu erstellten Profilen nachträglich Adressnachweise zugeordnet werden können, wird noch geprüft. Wenn die Adresse abgelehnt wird, prüfen Sie die Angaben im Portal oder wenden Sie sich an den Support, bevor Sie es erneut versuchen.

Nachweis erstellen

Verwenden Sie ein freigeschaltetes MultiTEL-API-Konto und die dafür zugelassene IP-Adresse. Die Beispiele verwenden Zugangsdaten für HTTP Basic aus Umgebungsvariablen; beachten Sie die Authentifizierungskonventionen für Ihren Kontotyp. Senden Sie Anfragen über HTTPS. Prüfen Sie sowohl die HTTP-Antwort als auch das Feld im JSON-Objekt status.code; Anwendungsfehler können auch mit HTTP 200 zurückgegeben werden. Die folgenden Beispiele sind fiktiv.

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

Anfragefelder
Feld	Bedeutung
`entity_type`	Verwenden Sie identities oder addresses. Wählen Sie die Kategorie, die sowohl zur Zielentität als auch zu den hochgeladenen Dateien passt.
`entity_id`	Kennung der Identität oder Adresse, die Ihrem Konto gehört. Verwenden Sie die Kennung, die Ihr Dokumentenablauf zurückgibt; ersetzen Sie sie nicht durch eine Telefonnummer oder die Kennung eines nicht zugehörigen Dokuments.
`proof_type_id`	Kennung des ausgewählten Nachweistyps. Sie muss mit dem beim Hochladen verwendeten Typ und der Anforderung übereinstimmen.
`encrypted_file_ids`	Nicht leeres JSON-Array mit Dateikennungen, die von create_encrypt_files zurückgegeben wurden. Die Dateien müssen demselben Konto gehören, dürfen noch nicht abgelaufen sein und müssen zur Kategorie der Entität passen. Dies ist keine Liste lokaler Dateipfade.

Auch Formulardaten werden akzeptiert, wenn encrypted_file_ids[] als Feld mehrfach angegeben wird. Verwenden Sie vorzugsweise ein echtes JSON-Array oder ein Formular-Array; senden Sie kein JSON-kodiertes Array als gewöhnlichen skalaren Formularwert.

Nachweiskennung aufbewahren

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

Eine erfolgreiche Antwort bestätigt, dass die Zuordnung des Nachweises erstellt wurde. Sie bestätigt weder die Genehmigung der Identität oder Adresse noch die Erfüllung aller länderspezifischen Anforderungen oder die Aktivierung einer Telefonnummer.

Fehler und abgelaufene Uploads

Der API-Code 500 wird bei fehlenden Pflichtangaben, Fehlern beim Netzbetreiber und einer ungültigen Antwort des Netzbetreibers verwendet. Code 404 wird verwendet, wenn die Zielentität nicht dem aktuellen Konto zugeordnet ist, der Nachweistyp ungültig ist, eine hochgeladene Datei für dieses Konto bzw. diese Kategorie nicht gefunden werden kann oder abgelaufen ist oder keine verwendbaren Dateikennungen mehr vorhanden sind. Lesen Sie status.msg zusammen mit dem Code.

Laden Sie eine abgelaufene erforderliche Datei mit der richtigen Nachweiskategorie erneut hoch, bevor Sie sie zuordnen. Wenn eine der angegebenen Dateien ungültig ist, bricht diese Verarbeitungsfunktion ab, bevor sie die Anfrage zur Erstellung des Nachweises sendet. Es wird kein Idempotenzschlüssel bereitgestellt: Prüfen Sie nach einer Zeitüberschreitung das vorhandene Dokument im Portal, bevor Sie die Zuordnung erneut versuchen.