ტელეფონის ნომრის ცნობარში ჩანაწერის გაგზავნა

ოპერატორის ცნობარში ჩანაწერის გაგზავნა

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

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

ანგარიშისა და ნომრის მოთხოვნები

გამოიყენეთ ჩართული API ანგარიში HTTPS კავშირით, ნებადართული წყაროს IP მისამართიდან. ზუსტად ეს ნომერი უნდა იყოს ამ ანგარიშის კუთვნილი შეძენილი ნომრების ჩანაწერი, რომელიც გაუქმებულად არ არის მონიშნული. გამოიყენეთ თქვენს ინვენტარში არსებული სრული საერთაშორისო ციფრები, მაგალითად, მხარდაჭერილი ჩრდილოამერიკული ნომრისთვის ქვეყნის კოდით 1 დაწყებული ფორმატი. არ გამოიყენოთ სატარიფო გეგმის იდენტიფიკატორი, ნომრის UUID ან სხვა ანგარიშის კუთვნილი ნომერი.

ფორმის POST მოთხოვნა

მიანიჭეთ NUMBER პარამეტრს თქვენს საკუთრებაში არსებული ნომრის მნიშვნელობა. გამოგონილი მაგალითი შეცვალეთ ჩანაწერის ნებადართული ინფორმაციით. ეს მარშრუტი ფორმის ველებს POST მოთხოვნიდან კითხულობს; იგი application/json ფორმატის სხეულს არ აანალიზებს.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "lastname=EXAMPLE" \
  --data-urlencode "firstname=EXAMPLE" \
  --data-urlencode "streetnum=1" \
  --data-urlencode "streetname=Example" \
  --data-urlencode "streetpredir=N" \
  --data-urlencode "streetpostdir=W" \
  --data-urlencode "city=Example City" \
  --data-urlencode "state=NY" \
  --data-urlencode "postalcode=10001" \
  "https://api.multitel.net/v3/directory/$NUMBER"

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

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

საფასურის ჩამოჭრა და ხელახლა ცდის ქცევა

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

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

პასუხი

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": ""
}

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

ძველი სისტემის შეცდომები

წაიკითხეთ როგორც HTTP სტატუსი, ისე JSON ველები status.code/status.msg. ავთენტიფიკაციამ და წყაროს IP მისამართის შეზღუდვებმაც შეიძლება გამოსადეგი პასუხის მიღება შეაფერხოს. განახლების მოთხოვნისთვის ნუ გამოიყენებთ GET მეთოდს ან მოთხოვნის სტრიქონის პარამეტრებს მხოლოდ იმიტომ, რომ ძველ დამმუშავებელს HTTP მეთოდის აშკარა შემოწმება არ აქვს.

ხელახლა ცდამდე გადაამოწმეთ

1. მოთხოვნის გაგზავნამდე გადაამოწმეთ ნომრის საკუთრება, ოპერატორთან მისი შესაბამისობა, ჩანაწერის მონაცემების ნებართვა და საფასური.
2. გაგზავნეთ ერთხელ და შეინახეთ ანგარიშის მხარეს მიღებული შედეგი ისე, რომ მომხმარებლის მისამართი საჯარო ჟურნალებში ან ანალიტიკაში არ გამჟღავნდეს.
3. შენახული ჩანაწერი და ტრანზაქციების ისტორია ანგარიშის მხარდაჭერილი პროცესით ან მხარდაჭერის სამსახურის დახმარებით შეამოწმეთ. დაელოდეთ ოპერატორის მიერ დადასტურებულ დამუშავების ვადას; ეს API ცვლილების გავრცელების გარანტირებულ ვადას არ განსაზღვრავს.
4. როდესაც შედეგი გაურკვეველია, ხელახლა ცდამდე მხარდაჭერის სამსახურს სთხოვეთ ოპერატორის შეკვეთისა და ადგილობრივი ანგარიშსწორების შეჯერება. განმეორებითი მოთხოვნა სტატუსის იდემპოტენტური შემოწმება არ არის.