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

POST/v3/get_requirements

რეგისტრაციის მოთხოვნების წაკითხვა

მიიღეთ რეგისტრაციის მოთხოვნები, რომლებიც ამჟამად ბრუნდება ქვეყნისა და ნომრის ტიპის სახელისთვის.

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

აირჩიეთ ქვეყანა და ნომრის ტიპი

აირჩიეთ რეგისტრაციის ქვეყანა, შემდეგ გამოიყენეთ სახელი, რომელსაც აბრუნებს get_document_number_types. გაგზავნეთ ეს სახელი როგორც number_type, და არა ტიპის ID ან ნომრების ზოგადი ძიების კატეგორია.

წაიკითხეთ დაბრუნებული ინსტრუქციები

შეინახეთ მოთხოვნისა და კავშირის ID-ები შესაბამისი იდენტობის/დოკუმენტების სამუშაო პროცესისთვის. ეს გამოძახება აბრუნებს მოთხოვნებს; ის არ ამოწმებს და არ აგზავნის თქვენს ფაილებს. მიჰყევით დაბრუნებულ ინსტრუქციებს და არჩეული ნომრისთვის სპეციფიკურ ნებისმიერ მოთხოვნას.

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

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

მოთხოვნა

გამოიყენეთ თქვენი ჩართული API ანგარიშის ავტორიზაციის მონაცემები HTTPS-ის საშუალებით. მხარდაჭერილია Basic ავთენტიფიკაცია და ჩართული API ანგარიშის bearer ტოკენები; მოქმედებს ანგარიშის შეზღუდვები.

POST მოთხოვნა application/json ან application/x-www-form-urlencoded ფორმატით.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  --request POST \
  --header "Content-Type: application/json" \
  --data '{"country":"US","number_type":"Local"}' \
  "https://api.multitel.net/v3/get_requirements"
სხეულის პარამეტრები
სახელიტიპისავალდებულოაღწერა
countryსტრიქონიდიახქვეყნის ISO კოდი get_document_countries-დან.
number_typeსტრიქონიდიახტიპის სახელი get_document_number_types-დან, მაგალითად Local; შესატყვისობა რეგისტრს არ ითვალისწინებს. მიუთითეთ სახელი და არა მისი ID.

პასუხი

შეამოწმეთ status.code JSON სხეულში, ისევე როგორც HTTP სტატუსი. response არის ერთი მოთხოვნების რესურსი id, type და attributes ველებით, პლუს relationships, როდესაც ის ბრუნდება. ID-ები რესურსისა და კავშირების მონაცემებში გაუმჭვირვალეა. არჩევით restriction_message ტექსტს HTML ტეგები მოცილებული აქვს; დარჩენილი ტექსტი დაამუშავეთ როგორც ტექსტი და არა როგორც სანდო HTML. დამმუშავებელი აბრუნებს პირველ მოთხოვნების რესურსს, ამიტომ არ დაასკვნათ, რომ ეს პასუხი ამომწურავი სიაა. ატრიბუტების/კავშირების ხელმისაწვდომობა დამოკიდებულია ქვეყანასა და ტიპზე; მაგალითი არ არის სრული ფიქსირებული სქემა.

პასუხის საილუსტრაციო ფორმა; არა ანგარიშის რეალური მონაცემები ან მიმდინარე ფასი.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "id": "REQUIREMENT_ID_FROM_RESPONSE",
    "type": "RESOURCE_TYPE_FROM_RESPONSE",
    "attributes": {
      "restriction_message": "Example country-specific instructions."
    }
  }
}

შეცდომები

  • 400: ქვეყნისა და number_type ვალიდაცია ვერ მოხერხდა: მიუთითეთ ორივე სავალდებულო მნიშვნელობა. ვალიდაციის ტექსტი შეიძლება შეიცავდეს ფორმატირებას.
  • 400: Invalid country ISO or No country registration documents required.: ეს ორაზროვანი შეტყობინება თავისთავად არ ამტკიცებს რეგისტრაციისგან გათავისუფლებას.
  • 400: Invalid number type: გამოიყენეთ დაბრუნებული ტიპის სახელი. მოძველებული შეცდომა ჩამოთვლის Global, Local, Mobile, National, Shared Cost და Toll Free ტიპებს.
  • 500: Unable to load registration requirements for the specified country and number type.: მოთხოვნები წარმატებით არ დაბრუნებულა. სცადეთ მოგვიანებით ან დაუკავშირდით მხარდაჭერას.

ხელმისაწვდომობა და გვერდითი ეფექტები

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