Kimlik veya adres kanıtı ekleme

Bu adımı, kimlik veya adres oluşturulduktan ve gerekli dosyaları create_encrypt_files aracılığıyla seçilen kanıt türüyle yükledikten sonra kullanın. Güncel bir tanımlayıcı almak için get_proof_types kullanın; tanımlayıcının gereksinime ve varlık kategorisine uygun olduğundan emin olun.

identity_id ve address_id değerlerini saklayın; bu değerleri döndüren işlem: create_document; profilin UUID değeri farklıdır. Yeni oluşturulan profillere sonradan adres kanıtı eklemenin uyumluluğu hâlâ incelenmektedir. Adres reddedilirse yeniden denemeden önce portalı kontrol edin veya destek birimine danışın.

Kanıtı oluşturma

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 doğrulama 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 yanıtıyla da gelebilir. Aşağıdaki örnekler kurgusaldır.

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

İstek alanları
Alan	Anlamı
`entity_type`	identities veya addresses değerini kullanın. Hem hedefinizle hem de yüklenen dosyalarla eşleşen kategoriyi seçin.
`entity_id`	Hesabınıza ait kimliğin veya adresin tanımlayıcısı. Belge iş akışınızın döndürdüğü tanımlayıcıyı kullanın; bunun yerine telefon numarası veya ilgisiz bir belgenin tanımlayıcısını kullanmayın.
`proof_type_id`	Seçilen kanıt türünün tanımlayıcısı. Yüklemede kullanılan türle ve gereksinimle tutarlı olmasını sağlayın.
`encrypted_file_ids`	JSON biçiminde, create_encrypt_files tarafından döndürülen dosya tanımlayıcılarını içeren ve boş olmayan bir dizi. Dosyalar aynı hesaba ait olmalı, süreleri dolmamış olmalı ve varlık kategorisiyle eşleşmelidir. Bu, yerel dosya yollarının listesi değildir.

Form verileri de kabul edilir; bunun için yinelenen encrypted_file_ids[] alanlarını kullanın. Gerçek bir JSON dizisi veya form dizisi tercih edin; JSON biçiminde kodlanmış bir diziyi sıradan bir skaler form değeri olarak göndermeyin.

Kanıt tanımlayıcısını saklama

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

Başarılı bir yanıt, kanıt ilişkilendirmesinin oluşturulduğunu doğrular. Kimliğin veya adresin onaylandığını, ülkeye ilişkin tüm gereksinimlerin karşılandığının doğrulandığını ya da bir telefon numarasının etkinleştirildiğini doğrulamaz.

Hatalar ve süresi dolan yüklemeler

API kodu 500; zorunlu girdilerin eksik olması, telekomünikasyon operatörü hataları ve geçersiz operatör yanıtı için kullanılır. 404 kodu; hedef mevcut hesapla ilişkili olmadığında, kanıt türü geçersiz olduğunda, yüklenen bir dosya bu hesap veya kategori için bulunamadığında ya da dosyanın süresi dolduğunda veya kullanılabilir hiçbir dosya tanımlayıcısı kalmadığında kullanılır. status.msg alanını da kodla birlikte okuyun.

Süresi dolan zorunlu bir dosyayı eklemeden önce doğru kanıt kategorisini kullanarak yeniden yükleyin. Sağlanan dosyalardan herhangi biri geçersizse bu istek işleyicisi, kanıt oluşturma isteğini göndermeden önce durur. Kullanıma sunulmuş bir idempotans anahtarı yoktur: zaman aşımından sonra ekleme işlemini tekrarlamadan önce portaldaki mevcut belgeyi kontrol edin.