CNAM ინტეგრაცია

CNAM REST API ცნობარი

მოითხოვეთ დამრეკის სახელი HTTPS-ით და დაამუშავეთ შედეგი, საფასური და შეცდომები.

CNAM-ის ვარიანტები და ფასები SIP ცნობარი

აირჩიეთ მოძიების ქცევა

დონე	საჯარო ფასი თითო მოთხოვნაზე	რას აკეთებს
Starter	0,0026 US$	იყენებს საკუთარ და ქეშირებულ დამრეკის სახელის ინფორმაციას.
Standard	0,0037 US$	თითოეული მოთხოვნისთვის ახორციელებს რეალურ დროში ქსელურ მოძიებას.
Mixed	0,004 US$	ჯერ ცდილობს რეალურ დროში მოძიებას, ხოლო თუ სახელი ვერ მოიძებნა, უბრუნდება Starter მონაცემებს.

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

გაგზავნეთ ავტორიზებული მოძიება

ენდპოინტი: GET https://api.multitel.net/v3/cnam/NUMBER. მიუთითეთ საერთაშორისო ნომერი მხოლოდ ციფრებით, ქვეყნის კოდის ჩათვლით, პუნქტუაციისა და საწყისი პლუსის გარეშე. მოთხოვნა თქვენი აპლიკაციის სერვერიდან, დამტკიცებული API ავტორიზაციის მონაცემებით შეასრულეთ.

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  "https://api.multitel.net/v3/cnam/12025550123"

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

API ავტორიზაციისა და პირველი მოთხოვნის სახელმძღვანელო

წაიკითხეთ JSON პასუხი

ეს პასუხი საილუსტრაციოა. დაბრუნებული სახელი და საფასური დამოკიდებულია მოძიებასა და არჩეულ სერვისზე.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "name": "EXAMPLE CALLER",
    "cost": "0.004",
    "balance": "24.9960"
  }
}

status.code: აპლიკაციის შედეგის კოდი; 200-თან შედარებამდე ნორმალიზება გაუკეთეთ სტრიქონულ/რიცხვით მნიშვნელობებს.
status.msg: თანმხლები შედეგის ან უარყოფის შეტყობინება.
response.number: მოძიებული ნომერი.
response.name: ხელმისაწვდომი დამრეკის სახელი.
response.cost: ამ მოთხოვნისთვის მითითებული საფასური; განიხილეთ როგორც ათწილადი თანხა.
response.balance: ანგარიშის მითითებული ბალანსი, თუ ის არსებობს.

უსახელო შედეგები და შეცდომები

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

response.name-ზე წვდომამდე გადაამოწმეთ როგორც HTTP სტატუსი, ისე JSON status. შეცდომისას პასუხის ობიექტი შეიძლება არ არსებობდეს. სახელის არარსებობამ არ უნდა შეაფერხოს ზარის ჩვეულებრივი მარშრუტიზაცია.

ბილინგი, განმეორებითი მცდელობები და განსხვავება გამომძახებლის იდენტიფიკაციის განახლებისგან

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

CNAM მოძიება კითხულობს სახელს. ის არ ცვლის სახელს, რომელიც ჩანს თქვენს გამავალ ზარებზე. LIDB დამრეკის სახელის განახლება ცალკე ოპერაციაა, საკუთარი ველებით, ავტორიზაციით, ფასითა და დამუშავებით.

ანგარიშის CNAM ინტეგრაციის სახელმძღვანელო მიიღეთ დახმარება ინტეგრაციაში