დეველოპერებისთვის

POST/v3/create_proof

პირადობის ან მისამართის დამადასტურებელი საბუთის მიბმა

ატვირთული დამადასტურებელი ფაილების შესაბამის პირადობასთან ან მისამართთან დაკავშირება.

ამ გვერდზე
  1. პირადობის ან მისამართის დამადასტურებელი საბუთის მიბმა
  2. დამადასტურებელი საბუთის შექმნა
  3. შეინახეთ დამადასტურებელი საბუთის იდენტიფიკატორი
  4. შეცდომები და ვადაგასული ატვირთული ფაილები

პირადობის ან მისამართის დამადასტურებელი საბუთის მიბმა

ეს ნაბიჯი გამოიყენეთ მას შემდეგ, რაც პირადობა ან მისამართი უკვე შექმნილია და მისი აუცილებელი ფაილები ატვირთულია ფუნქციით create_encrypt_files არჩეული დამადასტურებელი საბუთის ტიპით. გამოიყენეთ მოქმედი იდენტიფიკატორი, რომელსაც აბრუნებს get_proof_types, მოთხოვნისა და ობიექტის კატეგორიის შესაბამისად.

შეინახეთ identity_id და address_id, რომლებსაც აბრუნებს create_document; პროფილის UUID განსხვავებულია. ახლად შექმნილ პროფილებზე მისამართის დამადასტურებელი საბუთის მოგვიანებით მიბმის თავსებადობა ჯერ კიდევ განხილვის პროცესშია. თუ მისამართი უარყოფილია, ხელახლა ცდამდე შეამოწმეთ პორტალი ან მიმართეთ მხარდაჭერის სამსახურს.

დამადასტურებელი საბუთის შექმნა

გამოიყენეთ MultiTEL-ის გააქტიურებული API ანგარიში და მისთვის ნებადართული IP მისამართი. მაგალითებში HTTP Basic ავთენტიფიკაციის მონაცემები გარემოს ცვლადებიდან მიიღება; დაიცავით თქვენი ანგარიშის ტიპისთვის გათვალისწინებული ავთენტიფიკაციის წესები. მოთხოვნები გაგზავნეთ HTTPS პროტოკოლით. შეამოწმეთ როგორც HTTP პასუხი, ისე JSON ობიექტის ველი status.code; აპლიკაციის შეცდომები შეიძლება HTTP 200 პასუხთან ერთად მოვიდეს. ქვემოთ მოცემული მაგალითები გამოგონილია.

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"
  ]
}
მოთხოვნის ველები
ველიმნიშვნელობა
entity_typeგამოიყენეთ identities ან addresses. აირჩიეთ კატეგორია, რომელიც შეესაბამება როგორც სამიზნე ობიექტს, ისე ატვირთულ ფაილებს.
entity_idთქვენი ანგარიშის კუთვნილი პირადობის ან მისამართის იდენტიფიკატორი. გამოიყენეთ დოკუმენტებთან მუშაობის პროცესში დაბრუნებული იდენტიფიკატორი; არ ჩაანაცვლოთ ის ტელეფონის ნომრით ან სხვა, დაუკავშირებელი დოკუმენტის იდენტიფიკატორით.
proof_type_idარჩეული დამადასტურებელი საბუთის ტიპის იდენტიფიკატორი. ის უნდა შეესაბამებოდეს ატვირთვისას გამოყენებულ ტიპსა და მოთხოვნას.
encrypted_file_idsფაილების იდენტიფიკატორების არაცარიელი JSON მასივი, რომელსაც აბრუნებს create_encrypt_files. ფაილები უნდა ეკუთვნოდეს იმავე ანგარიშს, მათი მოქმედების ვადა არ უნდა იყოს გასული და ისინი უნდა შეესაბამებოდეს ობიექტის კატეგორიას. ეს არ არის ლოკალური ფაილების ბილიკების სია.

ასევე მიიღება ფორმის მონაცემები განმეორებადი encrypted_file_ids[] ველებით. უპირატესობა მიანიჭეთ ნამდვილ JSON მასივს ან ფორმის მასივს; არ გაგზავნოთ JSON ფორმატში კოდირებული მასივი ფორმის ჩვეულებრივი სკალარული მნიშვნელობის სახით.

შეინახეთ დამადასტურებელი საბუთის იდენტიფიკატორი

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

წარმატებული პასუხი ადასტურებს დამადასტურებელი საბუთის კავშირის შექმნას. ის არ ადასტურებს პირადობის/მისამართის დამტკიცებას, ქვეყნის ყველა მოთხოვნის დაკმაყოფილების შემოწმებას ან ტელეფონის ნომრის გააქტიურებას.

შეცდომები და ვადაგასული ატვირთული ფაილები

API კოდი 500 გამოიყენება აუცილებელი შემავალი მონაცემების არქონის, სატელეკომუნიკაციო ოპერატორის შეფერხებებისა და ოპერატორის არავალიდური პასუხის შემთხვევაში. კოდი 404 გამოიყენება, როდესაც სამიზნე ობიექტი მიმდინარე ანგარიშთან არ არის დაკავშირებული, დამადასტურებელი საბუთის ტიპი არავალიდურია, ატვირთული ფაილი ამ ანგარიშისთვის/კატეგორიისთვის ვერ მოიძებნა ან მისი მოქმედების ვადა გასულია, ან გამოსაყენებელი ფაილის იდენტიფიკატორები აღარ დარჩა. წაიკითხეთ status.msg კოდთან ერთად.

მიბმამდე ხელახლა ატვირთეთ ვადაგასული აუცილებელი ფაილი დამადასტურებელი საბუთის სწორი კატეგორიის გამოყენებით. თუ რომელიმე მოწოდებული ფაილი არავალიდურია, ეს დამმუშავებელი ჩერდება დამადასტურებელი საბუთის შექმნის მოთხოვნის გაგზავნამდე. იდემპოტენტურობის გასაღები ხელმისაწვდომი არ არის: ლოდინის დროის ამოწურვის შემდეგ, მიბმის გამეორებამდე, პორტალში შეამოწმეთ არსებული დოკუმენტი.