Eerst uploaden, dan koppelen
Upload de bestanden voor één categorie bewijsstukken of aanvullende documenten en koppel vervolgens de ontvangen bestands-ID's met create_proof of create_supporting_document. Alleen uploaden maakt geen identiteit, adres of bewijsstuk aan en voltooit geen nummerregistratie. Begin met de actuele vereisten en de ID's uit de catalogi.
Geef precies één selectieparameter op: proof_type_id voor een identiteits- of adresbewijs, of supporting_template_id voor een aanvullend document. Stuur niet beide mee. Gebruik ID's die door de betreffende MultiTEL-catalogus zijn geretourneerd; behandel ze als identificatoren waarvan de inhoud niet geïnterpreteerd mag worden.
Uploadverzoek
Gebruik een ingeschakeld MultiTEL API-account en het daarvoor toegestane IP-adres. De voorbeelden gebruiken aanmeldgegevens voor HTTP Basic uit omgevingsvariabelen; volg de authenticatieregels voor uw accounttype. Verstuur verzoeken via HTTPS. Controleer zowel het HTTP-antwoord als het JSON-veld status.code; toepassingsfouten kunnen met HTTP 200 worden geretourneerd. De onderstaande voorbeelden zijn fictief.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--form-string "proof_type_id=$PROOF_TYPE_ID" \
--form-string 'description=Identity proof' \
--form 'files[0]=@./identity-proof.pdf' \
https://api.multitel.net/v3/create_encrypt_files| Veld | Betekenis |
|---|---|
files[0] … files[4] | Eén tot vijf geüploade bestanden. Gebruik multipart-formuliergegevens en laat curl de scheidingsgrens voor Content-Type genereren. Deze velden bevatten bestandsbytes, geen URL's of Base64-gegevens in JSON. |
proof_type_id | Verplicht bij het uploaden van een bewijsstuk; gebruik een geretourneerde ID van het bewijstype. Laat supporting_template_id weg. |
supporting_template_id | Verplicht in plaats van proof_type_id voor bestanden van aanvullende documenten; gebruik een geretourneerde sjabloon-ID. |
description | Optionele beschrijving die de aanroeper opgeeft, met maximaal 100 tekens. Bij een upload van aanvullende documenten kan de sjabloonnaam worden gebruikt als de beschrijving ontbreekt. |
Bestandslimieten
Deze handler accepteert maximaal vijf bestanden met in totaal maximaal 20,000,000 bytes. Dit is een decimale limiet in bytes, geen 20 MiB. De infrastructuur of MIME-validatie kan aanvullende limieten opleggen.
De toegestane extensies zijn pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf en csv. Een toegestane extensie bewijst niet dat een bestand aan de gekozen registratievereiste voldoet. Met name tif staat niet op deze lijst met toegestane extensies.
Controleer elk geretourneerd bestand
{
"status": {
"code": 200,
"msg": "Encrypt file has been created successfully"
},
"response": {
"entity_type": "identities",
"document_category": "proof",
"proof_type": "11111111111111111111111111111111",
"ids": [
{
"id": "22222222222222222222222222222222",
"name": "identity-proof.pdf",
"expired_at": "2026-10-23 16:20:00"
}
]
}
}Bewaar elke response.ids[].id voor het koppelverzoek. Het veld name geeft de geretourneerde oorspronkelijke bestandsnaam aan. Gebruik verschillende bestandsnamen en vergelijk de geretourneerde bestanden met de verwachte set: code 200 kan betekenen dat een batch slechts gedeeltelijk is geslaagd. Koppel geen set waarin verplichte bestanden ontbreken.
entity_type is identities of addresses voor een bewijsstuk, en supporting_documents voor een upload van aanvullende documenten. Het veld document_category is proof of supporting. Het antwoordveld met de algemene naam proof_type bevat bij uploads van aanvullende documenten ook een sjabloonverwijzing; bewaar uw oorspronkelijke supporting_template_id voor het koppelen.
Koppel de bestanden zo snel mogelijk
De dienst stelt een vervaltijd in op ongeveer 20 minuten na het lokaal opslaan van de upload. Bij het koppelen wordt gecontroleerd of het bestand bij hetzelfde account hoort, niet als verlopen is gemarkeerd, de vervaltijd nog niet heeft bereikt en de juiste entiteitscategorie heeft. Het veld expired_at bevat in dit antwoord geen tijdzoneverschil; ga er niet van uit dat het om UTC gaat. Koppel de bestanden zo snel mogelijk en plan de verwerking niet vlak voor de vervaltijd.
Het verlopen van de uploadverwijzing garandeert niet dat alle opgeslagen documentkopieën op dat moment worden verwijderd. De dienst versleutelt bestanden voor de upload naar de telecomaanbieder en bewaart de oorspronkelijke bytes voor het documentproces; beschouw dit niet als versleuteling uitsluitend aan de clientzijde of als een dienst die geen gegevens bewaart. Houd ID's, bestandsnamen en antwoorden buiten openbare logboeken.
Fouten en nieuwe pogingen
De huidige handler gebruikt API-code 404 als er geen documentbestanden zijn aangeleverd en code 500 bij fouten in de beschrijvingsvalidatie, ontbrekende of conflicterende selectieparameters, ongeldige bewijs- of sjabloon-ID's, overschrijding van de limiet voor het aantal bestanden of de totale grootte, opslagproblemen of een mislukte upload. Lees status.msg; ongeldige invoer wordt niet consequent met code 400 aangeduid.
Hier is geen idempotentiesleutel voor de client beschikbaar. Als het antwoord verloren gaat, controleer dan het documentproces voordat u een upload herhaalt; een nieuw verzoek kan nieuwe bestandsverwijzingen aanmaken. Deze voorbeelden zijn niet uitgevoerd met identiteitsdocumenten van klanten.