İliştirmeden önce yükleyin
Tek bir kanıt veya destekleyici belge kategorisine ait dosyaları yükleyin, ardından döndürülen dosya kimliklerini iliştirmek için şu işlemlerden birini kullanın: create_proof veya create_supporting_document. Yalnızca yükleme yapmak kimlik, adres, kanıt veya tamamlanmış bir numara kaydı oluşturmaz. Başlangıç olarak güncel gereksinimler listesini ve katalog kimliklerini inceleyin.
Yalnızca bir seçim alanı belirtin: proof_type_id kimlik/adres kanıtı için veya supporting_template_id destekleyici belge için kullanılır. İkisini birden göndermeyin. İlgili MultiTEL kataloğundan döndürülen kimlikleri kullanın; bunları iç yapılarından anlam çıkarılmaması gereken tanımlayıcılar olarak ele alın.
Yükleme isteği
Etkin bir MultiTEL API hesabı ve bu hesap için izin verilen IP adresini kullanın. Örneklerde ortam değişkenlerinden alınan HTTP Basic kimlik bilgileri kullanılır; hesap türünüzün kimlik doğrulama kurallarına uyun. İstekleri HTTPS üzerinden gönderin. Hem HTTP yanıtını hem de JSON içindeki şu alanı kontrol edin: status.code; uygulama hataları HTTP 200 ile gelebilir. Aşağıdaki örnekler kurgusaldır.
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| Alan | Anlamı |
|---|---|
files[0] … files[4] | Bir ila beş yüklenen dosya. Çok parçalı form verisi kullanın ve Content-Type sınır ayırıcısını curl aracının oluşturmasını sağlayın. Bu alanlar URL veya JSON Base64 verisi değil, dosya baytlarını içerir. |
proof_type_id | Kanıt yüklemesi için zorunludur; döndürülen şu kimliği kullanın: kanıt türü kimliği. supporting_template_id alanını göndermeyin. |
supporting_template_id | Destekleyici dosyalar için proof_type_id yerine zorunludur; döndürülen şu kimliği kullanın: şablon kimliği. |
description | İsteği gönderenin sağlayabileceği, en fazla 100 karakterlik isteğe bağlı açıklama. Açıklama belirtilmezse destekleyici belge yüklemesinde şablon adı kullanılabilir. |
Dosya sınırları
Bu istek işleyicisi en fazla beş dosya ve toplam 20,000,000 bayt kabul eder. Bu, ondalık tabanlı bir bayt sınırıdır; 20 MiB değildir. Altyapı veya MIME doğrulaması ek sınırlar uygulayabilir.
İzin verilen uzantılar şunlardır: pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf ve csv. Bir uzantıya izin verilmesi, dosyanın seçilen kayıt gereksinimini karşıladığını göstermez. Özellikle tif bu izin listesinde yer almaz.
Döndürülen her dosyayı kontrol edin
{
"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"
}
]
}
}Her dosya için response.ids[].id değerini iliştirme isteğinde kullanmak üzere saklayın. name alanı, döndürülen kaynak dosya adını belirtir. Birbirinden farklı dosya adları kullanın ve döndürülen dosyaları beklenen dosya kümesiyle karşılaştırın: 200 kodu, toplu işlemin kısmen başarılı olduğunu gösterebilir. Gerekli dosyaların eksik olduğu bir kümeyi iliştirmeyin.
entity_type alanının alabileceği değerler identities veya addresses (kanıt için), ayrıca supporting_documents (destekleyici belge yüklemesi için) şeklindedir. document_category alanının değeri proof veya supporting olabilir. Genel bir ad taşıyan proof_type yanıt alanı, destekleyici belge yüklemelerinde şablon referansını da taşır; iliştirme işlemi için özgün supporting_template_id değerinizi saklayın.
Gecikmeden iliştirin
Hizmet, yüklemenin yerel olarak depolanmasından yaklaşık 20 dakika sonrası için bir son geçerlilik zamanı belirler. İliştirme sırasında dosyanın aynı hesaba ait olduğu, süresi dolmuş olarak işaretlenmediği, henüz son geçerlilik zamanına ulaşmadığı ve doğru varlık kategorisinde olduğu kontrol edilir. expired_at alanında bu yanıtta saat dilimi farkı bulunmaz; UTC olduğunu varsaymayın. İşlemi sürenin dolacağı ana planlamak yerine gecikmeden iliştirin.
Yükleme referansının süresinin dolması, saklanan tüm belge kopyalarının o anda silineceği anlamına gelmez. Hizmet, operatöre yükleme için dosyaları şifreler ve belge iş akışı için kaynak baytlarını saklar; bunu yalnızca istemci tarafında şifreleme yapan veya veri saklamayan bir hizmet olarak değerlendirmeyin. Kimlikleri, dosya adlarını ve yanıtları herkese açık günlüklere kaydetmeyin.
Hatalar ve yeniden denemeler
Mevcut istek işleyicisi, belge dosyaları sağlanmadığında 404 API kodunu; açıklama doğrulama sorunları, eksik veya çelişen seçim alanları, geçersiz kanıt/şablon kimlikleri, dosya sayısı veya toplam boyut sınırı, depolama sorunları ya da başarısız yükleme için 500 kodunu kullanır. Şu alanı okuyun: status.msg; geçersiz girdi her zaman 400 koduyla gösterilmez.
Burada istemcinin kullanabileceği bir idempotans anahtarı sunulmaz. Yanıt kaybolursa yüklemeyi tekrarlamadan önce belge iş akışını kontrol edin; başka bir istek yeni dosya referansları oluşturabilir. Bu örnekler müşteri kimlik belgeleriyle çalıştırılmamıştır.