LINK Mobility დანერგვის სახელმძღვანელო REST API SMS
LINK Mobility გთავაზობთ სერვისს შეტყობინებების მიწოდებისთვის, მიკრო გადახდებისთვის და მდებარეობაზე დაფუძნებული სერვისებისთვის. პლატფორმა მოქმედებს როგორც გამჭვირვალე, თეთრი ეტიკეტის შინაარსის შემძენი და ტრანზაქციის როუტერი სერვის პროვაიდერებსა და ოპერატორებს შორის.
LINK Mobility უზრუნველყოფს RESTful API-ს, რომელიც შეიძლება გამოყენებულ იქნას LINK Mobility სერვისებზე წვდომისთვის, როგორიცაა SMS გაგზავნა. ეს API შექმნილია იმისთვის, რომ იყოს მარტივი გამოსაყენებელი და თავსებადი ყველა თანამედროვე ენასთან და ჩარჩოსთან. თქვენი არჩეული ენის გამოყენებით, თქვენს აპლიკაციას შეუძლია გამოიყენოს Link Mobility REST API ძლიერი შეტყობინებების და გადახდის შესაძლებლობების განსახორციელებლად
© LINK Mobility, 10 წლის 2021 მარტი
იურიდიული ინფორმაცია
ამ დოკუმენტში მოწოდებული ინფორმაცია არის Netsize-ის ერთადერთი საკუთრება და საავტორო უფლება. ის კონფიდენციალურია და განკუთვნილია მკაცრად ინფორმაციული გამოყენებისთვის. ის არ არის სავალდებულო და შესაძლოა შეიცვალოს გაფრთხილების გარეშე. ნებისმიერი არასანქცირებული გამჟღავნება ან გამოყენება ჩაითვლება უკანონოდ.
Netsize™ და linkmobility™ დაცულია ფრანგული, EEC და ინტელექტუალური საკუთრების საერთაშორისო კანონებით.
ყველა სხვა ციტირებული სავაჭრო ნიშანი არის მათი შესაბამისი მფლობელების ერთადერთი საკუთრება.
აქ მოცემული არაფერი არ უნდა იქნას გაგებული, როგორც რაიმე ლიცენზიის ან უფლების მინიჭება Netsize-ის პატენტის, საავტორო უფლებების ან სავაჭრო ნიშნის მიხედვით.
NETSIZE
Société anonyme au capital de 5 478 070 ევრო
Siège social :62, გამზირი Emile Zola92100 Boulogne – საფრანგეთი
418 712 477 RCS Nanterre
http://www.LinkMobility.com
http://www.linkmobility.com
დოკუმენტის ფარგლები
ეს დოკუმენტი აღწერს, თუ როგორ იყენებს სერვის პროვაიდერი LINK Mobility REST API-ს SMS-ისთვის. იგი განკუთვნილია ტექნიკური არქიტექტორებისა და დიზაინერებისთვის, რომლებიც ახორციელებენ სერვის პროვაიდერის მომსახურებას.
1. ძირითადი გამოყენება
SMS-ის გაგზავნა ძალიან მარტივია. თქვენ უგზავნით HTTP მოთხოვნას LINK Mobility-ს, რომელიც შეიძლება განხორციელდეს მხოლოდ ა web ბრაუზერი.
2. ფუნქციონალური დასრულდაview
LINK Mobility სისტემა უზრუნველყოფს SMS შეტყობინებების შემდეგ ძირითად ფუნქციებს:
მობილური შეწყვეტილი (MT) SMS შეტყობინებების გაგზავნა, როგორიცაა ტექსტური ან ორობითი (მაგ. WAP Push) პრემიუმ და სტანდარტული კურსის შეტყობინებები.
გაგზავნილი MT შეტყობინებების მიწოდების ანგარიშების მიღება.
მობილური წარმოშობის (MO) SMS შეტყობინებების მიღება, პრემიუმ და სტანდარტული ტარიფი.
SMS REST API ეძღვნება სტანდარტული განაკვეთის MT SMS შეტყობინებების გაგზავნას.
API აგზავნის ყველა SMS შეტყობინებას ასინქრონულად, რაც საშუალებას აძლევს ფუნქციებს, როგორიცაა:
„ცეცხლი და დაივიწყე“ - სერვის პროვაიდერს სურს ჰქონდეს უფრო პროგნოზირებადი რეაგირების დრო და არ სურს ოპერატორის შედეგს დაელოდოს.
ხელახლა სცადეთ ფუნქციონალობა – LINK Mobility ხელახლა გაუგზავნის შეტყობინებას, თუ ოპერატორს აქვს დროებითი პრობლემები.
2.1 SMS შეტყობინების გაგზავნა
სერვისის პროვაიდერი Netsize Consumer
- გაგზავნეთ MT შეტყობინება
- დააბრუნეთ შეტყობინების ID
- გაგზავნეთ SMS შეტყობინება
- მიწოდების ანგარიში
- გაგზავნეთ მიწოდების ანგარიში
SMS შეტყობინებების გაგზავნის ძირითადი ნაკადი აღწერილია შემდეგნაირად:
სერვისის პროვაიდერი ითხოვს SMS შეტყობინების გაგზავნას მიმღებს LINK Mobility სისტემის მეშვეობით.
შეტყობინების ID უბრუნდება სერვის პროვაიდერს. ეს პირადობის მოწმობა შეიძლება გამოყენებულ იქნას, მაგალითად, შეტყობინების შესაერთებლად მიწოდების სწორ ანგარიშთან.
LINK Mobility ახორციელებს მარშრუტიზაციას და აწვდის SMS შეტყობინებას მიმართულ მომხმარებელს.
მიწოდების ანგარიში ამოქმედდება, მაგ., როდესაც SMS შეტყობინება მიეწოდება მომხმარებლის მოწყობილობას.
მიწოდების ანგარიში ეგზავნება სერვისის პროვაიდერს. ანგარიში შეიცავს იმავე შეტყობინების ID-ს, რაც დაბრუნდა მე-2 ნაბიჯში.
ალტერნატიული ნაკადი: არასწორი მოთხოვნა
თუ მოთხოვნაში მოწოდებული პარამეტრები ან მომხმარებლის სერთიფიკატები არასწორია, შეცდომა უბრუნდება სერვისის პროვაიდერს. შეცდომა მიუთითებს უარის მიზეზზე და ნაკადი მთავრდება. შეტყობინებების ID არ ბრუნდება.
3. ბოლო წერტილი
SMS რესურსზე წვდომა ხდება ბილიკის გამოყენებით:
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
კავშირის უსაფრთხოებისთვის LINK Mobility REST API ხელმისაწვდომია მხოლოდ HTTPS-ით.
Link Mobility სერვერის სერთიფიკატი ხელმოწერილია Thawte Server CA-ს მიერ.
4. ოპერაციები
SMS სერვისი უზრუნველყოფს შემდეგ ოპერაციებს:
| სახელი | ბილიკი |
| გაგზავნა | /restapi/v1/sms/send |
4.1 გაგზავნა
გაგზავნის ოპერაცია გამოიყენება SMS-ის გაგზავნისთვის ერთ მიმღებზე.
ეს ოპერაცია განკუთვნილია როგორც ძირითადი, ასევე მოწინავე მომხმარებლებისთვის. უმარტივეს შემთხვევაში, SMS-ის მიწოდებისთვის საჭიროა მხოლოდ დანიშნულების მისამართი და შეტყობინების ტექსტი. LINK Mobility აღმოაჩენს მონაცემთა კოდირების სქემას და საჭიროების შემთხვევაში შეასრულებს შეტყობინების ავტომატურ შეერთებას შეტყობინების მრავალ ნაწილს.
გაფართოებული გამოყენებისთვის, სერვის პროვაიდერს შეუძლია გამოიყენოს არასავალდებულო პარამეტრები შეტყობინების ფორმატირების სრული კონტროლისთვის, მომხმარებლის მონაცემების სათაურის ჩათვლით.
სერვისის პროვაიდერს შეუძლია გაგზავნოს თანმიმდევრული შეტყობინებები, მაგრამ მომხმარებლის მონაცემებისა და მომხმარებლის მონაცემების სათაურის მომზადება უნდა განხორციელდეს სერვისის პროვაიდერის მიერ და შეტყობინება უნდა გაიგზავნოს LINK Mobility-ზე გაგზავნის მრავალჯერადი მოთხოვნის საშუალებით.
5. ავთენტიფიკაცია
მომხმარებლის სახელი და პაროლი წარმოდგენილია ყველა მოთხოვნაში HTTP ძირითადი ავთენტიფიკაციის სქემის გამოყენებით.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
სერთიფიკატები იგზავნება ავტორიზაციის სათაურში HTTP მოთხოვნაში. კლიენტი აშენებს სათაურის ველს, როგორც ეს აღწერილია აქ:
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
მაგampთუ მომხმარებლის სახელი არის john და changeme არის პაროლი, შედეგად ავტორიზაციის სათაური არის:
ავტორიზაცია: ძირითადი am9objpjaGFuZ2VtZSA=
დაბრუნების სახით მომხმარებლის სახელი და პაროლი შეიძლება წარმოდგენილი იყოს მოთხოვნის პარამეტრებად. ეს რეკომენდირებულია მხოლოდ კლიენტებისთვის, რომლებსაც არ აქვთ ძირითადი ავტორიზაციის მხარდაჭერა.
6. მოთხოვნის წარდგენა
6.1 შეკითხვის სტრიქონი
მოთხოვნის პარამეტრები წარმოდგენილია მოთხოვნის სტრიქონის სახით, რომელიც შეიცავს სახელს/მნიშვნელობის წყვილებს. მოთხოვნის სტრიქონი დაშიფრულია პროცენტული კოდირების გამოყენებით (URL კოდირება).
http://www.w3schools.com/tags/ref_urlencode.asp
მაგampლე, გამარჯობა მსოფლიო! დაშიფრულია როგორც Hello+World%21.
6.2 სავალდებულო მოთხოვნის პარამეტრები
| სახელი | მაქსიმალური სიგრძე | აღწერა |
| დანიშნულების მისამართი | 40 | MSISDN, რომელზეც SMS შეტყობინება უნდა გაიგზავნოს, დაწყებული ქვეყნის კოდით. მაგampლ: 46123456789. ზოგიერთი ბაზრისთვის (სადაც Consumer MSISDN უნდა იყოს ბუნდოვანი) ეს მნიშვნელობა ასევე შეიძლება იყოს ალფანუმერული მეტსახელი, პრეფიქსით „#“. |
| შეტყობინების ტექსტი | 1600 | SMS შეტყობინების შინაარსი. |
6.3 სურვილისამებრ მოთხოვნის პარამეტრები (მოწინავე გამოყენებისთვის)
| სახელი | მაქსიმალური სიგრძე | აღწერა |
| ორიგინალური მისამართი | 16 | გამავალი SMS შეტყობინების საწყისი მისამართი. საწყისი მისამართის ტიპი განისაზღვრება originatorTON პარამეტრით. მოკლე ნომრის მაქსიმალური სიგრძეა 16. ალფა რიცხვითი გამომგზავნი შემოიფარგლება GSM ნაგულისხმევი ანბანით, მაქსიმალური სიგრძით 11 სიმბოლო. MSISDN გამგზავნის მაქსიმალური სიგრძეა 15 (იგივე ფორმატის გამოყენებით, როგორც დანიშნულების მისამართის ელემენტი). შეიძლება გამოტოვდეს სისტემის მიერ originatingAddress და originatingTON შერჩევისას. ეს ფუნქცია დამოკიდებულია ბაზარსა და კონფიგურაციაზე. ქცევა შეიძლება განსხვავდებოდეს ოპერატორის ინტეგრაციის მიხედვით. |
| შემქმნელიTON | 1 | საწყისი მისამართის ტიპის ნომერი (TON): 0 - მოკლე ნომერი 1 – ალფა რიცხვითი (მაქს. სიგრძე 11) 2 – MSISDN შეიძლება გამოტოვდეს, როდესაც originatingAddress და originatingTON შეირჩევა სისტემის მიერ. ეს ფუნქცია დამოკიდებულია ბაზარზე და კონფიგურაციაზე. ქცევა შეიძლება განსხვავდებოდეს ოპერატორის ინტეგრაციის მიხედვით. |
| userDataHeader | 280 | მომხმარებლის მონაცემების სათაური მომხმარებლის მონაცემებთან ერთად შეიძლება შეიცავდეს 140-მდე, ანუ 280-მდე თექვსმეტობით კოდირებული ოქტეტს. ეს პარამეტრი ყოველთვის ექვსკუთხედით არის დაშიფრული. |
| DCS | 3 | მონაცემთა კოდირების სქემა. ქცევა შეიძლება განსხვავდებოდეს ოპერატორის ინტეგრაციის მიხედვით. |
| PID | 3 | პროტოკოლის ID. ქცევა შეიძლება განსხვავდებოდეს ოპერატორის ინტეგრაციის მიხედვით. |
| relativeValidityTime | 6 | შედარებითი მოქმედების დრო წამებში (LINK Mobility-ზე წარდგენის დროსთან შედარებით). მაქსიმალური მნიშვნელობა არის 604800 (7 დღე) და ნაგულისხმევი არის 48 საათი. ქცევა შეიძლება განსხვავდებოდეს ოპერატორის ინტეგრაციის მიხედვით. |
| მიწოდების დრო | 20 | დროულიamp როდის უნდა მოხდეს SMS შეტყობინების მიწოდება (დაგვიანებული მიწოდების დრო). იხილეთ სექცია თარიღის დროის ფორმატის შესახებ. |
| statusReport დროშები | 1 | ანგარიშის მოთხოვნის მიწოდება: 0 - მიწოდების ანგარიში არ არის (ნაგულისხმევი) 1 - მოთხოვნილია მიწოდების ანგარიში 9 – მოთხოვნილია სერვერის მიწოდების ანგარიში (LINK Mobility არ აგზავნის ანგარიშს სერვისის პროვაიდერს, მაგრამ მას ხელმისაწვდომს ხდის ანგარიშებში და ა.შ.) |
| campaignName | 50 | LINK Mobility ტრანზაქციები არის tagამ სახელწოდებით. იგი გამოიყენება ტრანზაქციების დასაჯგუფებლად Link Mobility ანგარიშებში. |
| maxConcatenated Messages | 1 | მნიშვნელობა 1-დან 10-მდე, რომელიც განსაზღვრავს დაშვებული თანმიმდევრული შეტყობინების რაოდენობას. ნაგულისხმევი არის 3. |
| კორელაციაId | 100 | სერვისის პროვაიდერის მიერ მოწოდებული ID, რომელიც გაიმეორება მიწოდების ანგარიშში. |
| მომხმარებლის სახელი | 100 | მოწოდებულია HTTP ძირითადი ავთენტიფიკაციის ალტერნატივად. |
| პაროლი | 100 | მოწოდებულია HTTP ძირითადი ავთენტიფიკაციის ალტერნატივად. |
6.4 HTTP მოთხოვნის მეთოდები
მაქსიმალური თავსებადობისთვის, API მხარს უჭერს HTTP GET და POST მოთხოვნის მეთოდებს. სხვა HTTP მეთოდები არ არის დაშვებული.
6.4.1 მიიღეთ
კოდირებული შეკითხვის სტრიქონი დართულია URL.
მიიღეთ
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=გამარჯობა+მსოფლიო%21
ავტორიზაცია: ძირითადი am9objpjaGFuZ2VtZSA=
6.4.2 პოსტი
დაშიფრული მოთხოვნის სტრიქონი წარმოდგენილია HTTP მოთხოვნის შეტყობინების ტექსტში. შინაარსი-ტიპი არის განაცხადი/x-www-ფორმა-urlკოდირებული.
პოსტი https://europe.ipx.com/restapi/v1/sms/send
მასპინძელი: europe.ipx.com
შინაარსის ტიპი: განცხადება / x-www- ფორმა-urlკოდირებული
ავტორიზაცია: ძირითადი am9objpjaGFuZ2VtZSA=
შინაარსი-სიგრძე: 57
destinationAddress=46123456789&messageText=გამარჯობა+მსოფლიო%21
6.5 თარიღი და დრო
REST API-ში პარამეტრები, რომლებიც წარმოადგენს თარიღსა და დროს, ყოველთვის არის UTC დროის სარტყელში (კოორდინირებული უნივერსალური დრო). Timestamps წარმოდგენილია როგორც სტრიქონი ამ ზუსტი ფორმატით:
2017-04-25T23:20:50Z
ეს წარმოადგენს 20 წუთსა და 50 წამს 23 წლის 25 აპრილის 2017 საათიდან UTC-ში.
7. საპასუხო შეტყობინება
მოთხოვნის შეტყობინების მიღებისა და ინტერპრეტაციის შემდეგ API პასუხობს HTTP საპასუხო გზავნილით.
7.1 HTTP სტატუსის კოდი
REST API ყოველთვის აბრუნებს HTTP სტატუსის კოდს 200 OK დამუშავებული მოთხოვნებისთვის. შეტყობინების ტექსტი შეიცავს პარამეტრის პასუხის კოდს, რომელიც გამოიყენება ზუსტი შედეგის დასადგენად.
7.2 შეტყობინების ტექსტი
შეტყობინების ტექსტი შედგება JSON-ისგან, რომელიც აღწერს მოთხოვნის შედეგს.
http://json.org/
Link Mobility JSON შეესაბამება Google JSON Style Guide-ს.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 რეაგირების პარამეტრები
| სახელი | მაქსიმალური სიგრძე | აღწერა |
| პასუხის კოდი | 3 | 0 მიუთითებს წარმატებულ გარიგებაზე. |
| პასუხიმესიჯი | 255 | პასუხის ტექსტური აღწერა, მაგ. შეცდომის ტექსტი. |
| დროისamp | 20 | თარიღი და დრო, როდესაც LINK Mobility დაამუშავა მოთხოვნა. (იხილეთ თარიღის/დროის ფორმატის განყოფილება). |
| traceId | 36 | ბმული Mobility შიდა იდენტიფიკატორი. გამოიყენება მხარდაჭერისა და პრობლემების მოსაგვარებლად. |
| messageIds | 10 x 36 | LINK Mobility უნიკალური შეტყობინების ID-ების მასივი ყოველი წარმატებული შეტყობინებისთვის (მრავალი შეტყობინების ID ბრუნდება, თუ შეტყობინება შეერთებულია). გამოტოვებულია წარუმატებლობის შემთხვევაში. |
7.4 ყოფილიampპასუხები
წარმატებები
HTTP/1.1 200 OK
შინაარსის ტიპი: აპლიკაცია/json
შინაარსი-სიგრძე: 144
თარიღი: ხუთ, 15 სექ 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”წარმატება”,”timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
აქ არის იგივე JSON ფორმატირებული წაკითხვისთვის:
{
“პასუხის კოდი“:0,
“პასუხიმესიჯი":"წარმატება",
“დროისamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“messageIds":["1-4850879008"] }
წარუმატებლობა
HTTP/1.1 200 OK
შინაარსის ტიპი: აპლიკაცია/json
შინაარსი-სიგრძე: 148
თარიღი: ხუთ, 15 სექ 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” არასწორი შესვლა ან არაავტორიზებული API გამოყენება”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
წარმატებები
HTTP/1.1 200 OK
შინაარსის ტიპი: აპლიკაცია/json
შინაარსი-სიგრძე: 144
თარიღი: ხუთ, 15 სექ 2016 13:20:31 GMT
{“responseCode”:0,”responseMessage”:”წარმატება”,”timeestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
აქ არის იგივე JSON ფორმატირებული წაკითხვისთვის:
{
“პასუხის კოდი“:0,
“პასუხიმესიჯი":"წარმატება",
“დროისamp“:”2016-0915T13:20:31Z”,
“traceId“:”f678d30879fd4adc25f2”,
“messageIds":["1-4850879008"] }
წარუმატებლობა
HTTP/1.1 200 OK
შინაარსის ტიპი: აპლიკაცია/json
შინაარსი-სიგრძე: 148
თარიღი: ხუთ, 15 სექ 2016 13:20:31 GMT
{“responseCode”:1,”responseMessage”:” არასწორი შესვლა ან არაავტორიზებული API გამოყენება”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 რეაგირების კოდები
პასუხის შემდეგი კოდები შეიძლება დაბრუნდეს გაგზავნის პასუხში:
| კოდი | ტექსტი | აღწერა |
| 0 | წარმატებები | წარმატებით შესრულდა. |
| 1 | არასწორი შესვლა ან არაავტორიზებული API გამოყენება | არასწორი მომხმარებლის სახელი ან პაროლი ან სერვისის პროვაიდერი აკრძალულია LINK Mobility-ის მიერ. |
| 2 | მომხმარებელი დაბლოკილია Link Mobility-ით | მომხმარებელი დაბლოკილია LINK Mobility-ის მიერ. |
| 3 | ოპერაცია არ არის გათვალისწინებული LINK Mobility-ის მიერ | ოპერაცია დაბლოკილია სერვისის პროვაიდერისთვის. |
| 4 | მომხმარებელი უცნობია LINK Mobility-სთვის | მომხმარებელი უცნობია LINK Mobility-სთვის. ან თუ მოთხოვნაში გამოყენებული იყო მეტსახელი; მეტსახელი არ მოიძებნა. |
| 5 | მომხმარებელმა დაბლოკა ეს სერვისი LINK Mobility-ში | მომხმარებელმა დაბლოკა ეს სერვისი LINK Mobility-ში. |
| 6 | საწყისი მისამართი არ არის მხარდაჭერილი | საწყისი მისამართი არ არის მხარდაჭერილი. |
| 7 | ალფა საწყისი მისამართი არ არის მხარდაჭერილი ანგარიშის მიერ | ალფა საწყისი მისამართი არ არის მხარდაჭერილი ანგარიშის მიერ. |
| 8 | MSISDN საწყისი მისამართი არ არის მხარდაჭერილი | MSISDN საწყისი მისამართი არ არის მხარდაჭერილი. |
| 9 | GSM გაფართოებული არ არის მხარდაჭერილი | GSM გაფართოებული არ არის მხარდაჭერილი. |
| 10 | Unicode არ არის მხარდაჭერილი | Unicode არ არის მხარდაჭერილი. |
| 11 | სტატუსის ანგარიში არ არის მხარდაჭერილი | სტატუსის ანგარიში არ არის მხარდაჭერილი. |
| 12 | საჭირო შესაძლებლობა არ არის მხარდაჭერილი | შეტყობინების გაგზავნისთვის საჭირო შესაძლებლობა (გარდა ზემოთ აღნიშნულისა) არ არის მხარდაჭერილი. |
| 13 | კონტენტის პროვაიდერის მაქსიმალური ჩახშობის მაჩვენებელი გადაჭარბებულია | სერვისის პროვაიდერი ძალიან სწრაფად აგზავნის SMS შეტყობინებებს LINK Mobility-ზე. |
| 14 | პროტოკოლის ID არ არის მხარდაჭერილი ანგარიშის მიერ | პროტოკოლის ID არ არის მხარდაჭერილი. |
| 15 | შეტყობინებების შეერთების ლიმიტი გადაჭარბებულია | თანმიმდევრული შეტყობინებების რაოდენობა აღემატება მოთხოვნილ მაქსიმალურ რაოდენობას. |
| 16 | შეტყობინების მარშრუტირება შეუძლებელია. | LINK Mobility-მ ვერ შეძლო შეტყობინების მარშრუტირება. |
| 17 | აკრძალული პერიოდი | დროის განმავლობაში შეტყობინების გაგზავნა არ არის დაშვებული |
| 18 | ძალიან დაბალი ბალანსი სერვისის პროვაიდერის ანგარიშზე | სერვისის პროვაიდერი დაბლოკილია ძალიან დაბალი ბალანსის გამო |
| 50 | ნაწილობრივი წარმატება | ნაწილობრივი წარმატება რამდენიმე მიმღებისთვის SMS შეტყობინების გაგზავნისას. |
| 99 | შიდა სერვერის შეცდომა | სხვა Link Mobility შეცდომა. დამატებითი ინფორმაციისთვის დაუკავშირდით LINK Mobility მხარდაჭერას. |
| 100 | არასწორი დანიშნულების მისამართი | დანიშნულების მისამართი (MSISDN, ან მეტსახელი) არასწორია. |
| 102 | არასწორი მითითებული (მიბმული) ID | მითითების ID არასწორია, შესაძლოა მითითების ID უკვე გამოყენებულია, ძალიან ძველი ან უცნობია. |
| 103 | ანგარიშის სახელი არასწორია | ანგარიშის სახელი არასწორია. |
| 105 | სერვისის მეტა მონაცემები არასწორია | სერვისის მეტა მონაცემები არასწორია. |
| 106 | არასწორი საწყისი მისამართი | საწყისი მისამართი არასწორია. |
| 107 | არასწორი ალფანუმერული საწყისი მისამართი | ალფანუმერული საწყისი მისამართი არასწორია. |
| 108 | მოქმედების დრო არასწორია | მოქმედების დრო არასწორია. |
| 109 | არასწორი მიწოდების დრო | მიწოდების დრო არასწორია. |
| 110 | შეტყობინების კონტენტი/მომხმარებლის მონაცემები არასწორია | მომხმარებლის მონაცემები, ანუ SMS შეტყობინება არასწორია. |
| 111 | შეტყობინების სიგრძე არასწორია | SMS შეტყობინების სიგრძე არასწორია. |
| 112 | მომხმარებლის მონაცემების არასწორი სათაური | მომხმარებლის მონაცემების სათაური არასწორია. |
| 113 | მონაცემთა კოდირების არასწორი სქემა | DCS არასწორია. |
| 114 | პროტოკოლის ID არასწორია | PID არასწორია. |
| 115 | არასწორი სტატუსის მოხსენების დროშები | სტატუსის მოხსენების დროშები არასწორია. |
| 116 | არასწორი TON | შემქმნელი TON არასწორია. |
| 117 | არასწორი გampაიგნის სახელი | ქampaign სახელი არასწორია. |
| 120 | არასწორი ლიმიტი მიბმული შეტყობინებების მაქსიმალური რაოდენობისთვის | თანმიმდევრული შეტყობინებების მაქსიმალური რაოდენობა არასწორია. |
| 121 | არასწორი msisdn საწყისი მისამართი | MSISDN საწყისი მისამართი არასწორია. |
| 122 | არასწორი კორელაციის ID | კორელაციის ID არასწორია. |
8. არჩევითი მახასიათებლები
8.1 MSISDN კორექტირება
MSISDN-ის შესწორება არის არასავალდებულო ფუნქცია, რომელიც შეიძლება ჩართოთ LINK Mobility მხარდაჭერით, მოთხოვნის შემთხვევაში.
ეს ფუნქცია შეასწორებს დანიშნულების მისამართებს და ასწორებს მათ საჭირო E.164 ფორმატში. გარდა ფორმატის კორექტირებისა, სისტემას ასევე შეუძლია შეასრულოს ბაზრის სპეციფიკური ფუნქციები, როგორიცაა საერთაშორისო ფრანგული ნომრების თარგმნა DOM-TOM (départements et territoires d'outre-mer) ნომრების შესასწორებლად, როცა ეს შესაძლებელია.
ქვემოთ მოცემულია რამდენიმე ყოფილიampშესწორებების რაოდენობა:
| გაგზავნილი დანიშნულების მისამართი | შესწორებული დანიშნულების მისამართი |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 წწ | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (ფრანგული ნომერი გადათარგმნილია DOM-TOM ნომრად) |
გარდა ამისა, შესაძლებელია ეროვნული ტელეფონის ნომრების დაშვება არჩეული ბაზრისთვის. როდესაც ეს ფუნქცია ჩართულია, ნებისმიერი საერთაშორისო ნომერი სხვა ბაზრებისთვის უნდა გაიგზავნოს თავდაპირველი „+“ ნიშნით, რათა განასხვავოს ისინი არჩეული ბაზრისგან.
ქვემოთ მოცემულია რამდენიმე ყოფილიampშესწორებები შესრულებულია შვედეთის (ქვეყნის კოდი 46) ნაგულისხმევი ბაზრის ეროვნული ნომრების გამოყენებისას.
| გაგზავნილი დანიშნულების მისამართი | შესწორებული დანიშნულების მისამართი |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | არასწორია, რადგან „+“ ნიშანი აკლია |
გაითვალისწინეთ, რომ შესწორებული MSISDN გამოიყენებს LINK Mobility-ს და ის დაბრუნდება მიწოდების ანგარიშებში.
დამატებითი ინფორმაციისთვის გთხოვთ, დაუკავშირდეთ LINK Mobility მხარდაჭერას.
8.2 სიმბოლოების შეცვლა
სიმბოლოების ჩანაცვლება არის არასავალდებულო ფუნქცია, რომელიც შეიძლება ჩართოთ LINK Mobility მხარდაჭერით, მოთხოვნის შემთხვევაში.
ეს ფუნქცია გადათარგმნის არა-GSM ანბანის სიმბოლოებს მომხმარებლის მონაცემებში (SMS ტექსტი) GSM ანბანის ეკვივალენტურ სიმბოლოებად, როდესაც DCS დაყენებულია „GSM“-ზე (17). მაგample "Seqüência de teste em Português" ითარგმნება როგორც "Seqüencia de teste em Portugues".
9. მიწოდების ანგარიშები
სერვისის პროვაიდერს შეუძლია, უზრუნველყოფის შემთხვევაში, მოითხოვოს SMS შეტყობინებების მიწოდების ანგარიშები ან გაგზავნილი MT შეტყობინებების მიწოდების შესახებ. ეს ანგარიშები ამოქმედდება ოპერატორის SMSC-ში, როდესაც MT შეტყობინება მიეწოდება მიზანმიმართულ მომხმარებელს ან წაიშლება, მაგ.
სერვის პროვაიდერს ეცნობება მხოლოდ SMS შეტყობინების საბოლოო სტატუსი, ანუ მიწოდებული ან წაშლილი. თითო MT შეტყობინება გენერირებულია მხოლოდ ერთი ანგარიში. წაშლილი სტატუსის შემთხვევაში, შეიძლება გამოყენებულ იქნას მიზეზის კოდი. მიზეზის კოდი მიუთითებს SMS შეტყობინების არ მიწოდების მიზეზზე.
ანგარიშები გადის LINK Mobility-ის მეშვეობით და იგზავნება სერვისის პროვაიდერთან HTTP პროტოკოლის გამოყენებით.
ანგარიშების მისაღებად სერვის პროვაიდერმა უნდა განახორციელოს მაგampJava Servlet ან ASP.NET გვერდი. ორივე იღებს HTTP GET ან POST მოთხოვნას.
პარამეტრები
მოთხოვნა მოიცავს შემდეგ პარამეტრებს:
| პარამეტრი | ტიპი | M/O/I* | ნაგულისხმევი მნიშვნელობა | მაქსიმალური სიგრძე | აღწერა |
| MessageId | სიმებიანი | M | – | 22 | MT შეტყობინების შეტყობინების ID, რომელსაც ეს ანგარიში შეესაბამება. |
| დანიშნულების მისამართი | სიმებიანი | M | – | 40 | მომხმარებლის MSISDN, ანუ ორიგინალური MT შეტყობინების დანიშნულების მისამართი. |
| სტატუსის კოდი | მთელი რიცხვი | M | 1 | სტატუსის კოდი მიუთითებს MT შეტყობინების სტატუსზე. მოქმედი სტატუსის კოდებია: 0 – მიწოდებულია 2 – წაშლილია (გამოიყენება მიზეზი) |
|
| TimeStamp | სიმებიანი | M | – | 20 | დრო, რომელიც მიუთითებს, როდის მიიღო მიწოდების ანგარიში LINK Mobility-ის მიერ. დროის ზონაamp არის CET ან CEST (ევროკავშირისთვის განსაზღვრული ზაფხულის დროით). ფორმატი: yyyyMMdd HH:mm:ss. |
| ოპერატორი | სიმებიანი | M | – | 100 | ოპერატორის სახელი, რომელიც გამოიყენება SMS შეტყობინების გაგზავნისას ან ანგარიშის სახელი, რომელიც გამოიყენება SMS შეტყობინების გაგზავნისას. ხელმისაწვდომი ოპერატორების სია მოწოდებულია LINK Mobility მხარდაჭერით. |
| მიზეზის კოდი | მთელი რიცხვი | O | – | 3 | მიზეზის კოდი მიუთითებს, თუ რატომ დასრულდა შეტყობინება წაშლილ სტატუსში. მოქმედი მიზეზის კოდებია: 100 – ვადაგასული 101 – უარყოფილია 102 - ფორმატის შეცდომა 103 - სხვა შეცდომა 110 – აბონენტი უცნობია 111 – აბონენტის დაბლოკვა 112 – აბონენტი არ არის უზრუნველყოფილი 113 – აბონენტი მიუწვდომელია 120 – SMSC უკმარისობა 121 – SMSC შეშუპება 122 – SMSC როუმინგი 130 - ტელეფონის შეცდომა 131 – სმარტფონის მეხსიერება გადაჭარბებულია ქცევა შეიძლება განსხვავდებოდეს ოპერატორის ინტეგრაციის მიხედვით. |
| OperatorTimeStamp | სიმებიანი | O | – | 20 | დრო, რომელიც მიუთითებს, როდის მოხდა მოხსენების გაშვება ოპერატორის SMSC-ში (თუ მოწოდებულია ოპერატორის მიერ). დროის ზონაamp არის CET ან CEST (ევროკავშირისთვის განსაზღვრული ზაფხულის დროით). ფორმატი: yyyyMMdd HH:mm:ss. |
| StatusText | სიმებიანი | O | – | 255 | ადგილი ოპერატორის დამატებითი ინფორმაციისთვის, მაგ., სტატუსის/მიზეზის მკაფიო ტექსტური აღწერა. ქცევა შეიძლება განსხვავდებოდეს ოპერატორის ინტეგრაციის მიხედვით. |
| კორელაციაId | სიმებიანი | O | – | 100 | SendRequest-ში ან SendTextRequest-ში მოწოდებული კორელაციის ID. |
| ოპერატორის ქსელის კოდი | მთელი რიცხვი | O | – | 6 | ოპერატორის მობილური ქსელის კოდი (MCC + MNC). |
* M = სავალდებულო, O = სურვილისამებრ, I = იგნორირებული.
სერვისის პროვაიდერმა უნდა უზრუნველყოს LINK Mobility სამიზნე URL მიწოდების ანგარიშებისთვის (სურვილისამებრ, HTTP ძირითადი ავთენტიფიკაციის სერთიფიკატების ჩათვლით). სერვისის პროვაიდერს შეუძლია აირჩიოს HTTP რომელი მეთოდის გამოყენება:
HTTP POST (რეკომენდირებულია)
HTTP GET.
ExampHTTP GET-ის გამოყენებით (წარმატებით მიწოდებული):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
ExampHTTP GET-ის გამოყენებით (არ არის მიწოდებული, ოპერატორმა მიაწოდა დროamp ღონისძიებისთვის):
პარამეტრები არის URL კოდირება.
სიმბოლოების კოდირება:
სერვისის პროვაიდერს შეუძლია აირჩიოს რომელი სიმბოლოების სასურველი კოდირება გამოიყენოს:
UTF-8 (რეკომენდირებულია)
ISO-8859-1.
9.1 მომსახურების მიმწოდებლის აღიარება
სერვისის პროვაიდერმა უნდა აღიაროს მიწოდების თითოეული ანგარიში. აღიარება შეიძლება იყოს დადებითი, ანუ მიწოდების ანგარიში წარმატებით მიღებული, ან უარყოფითი, ანუ წარუმატებლობა.
გთხოვთ გაითვალისწინოთ: LINK Mobility-ს აქვს 30 წამის წაკითხვის ვადა მიწოდების ანგარიშებისთვის დადასტურებისთვის. დროის ამოწურვა გამოიწვევს მიწოდების ხელახლა ცდას (თუ ხელახალი ცდა ჩართულია) ან მიწოდების გაუქმებას (თუ ხელახალი ცდა გამორთულია). ეს ნიშნავს, რომ სერვის პროვაიდერის აპლიკაციამ უნდა უზრუნველყოს სწრაფი რეაგირების დრო, განსაკუთრებით მაღალი დატვირთვის დროს.
რეკომენდირებულია მიწოდების ანგარიშის აღიარება LINK Mobility-ის მიმართ მის დამუშავებამდე.
დადებითი და უარყოფითი აღიარების წესი აღწერილია შემდეგნაირად:
დადებითი აღიარება, ACK, მიწოდების ანგარიში:
HTTP 200 დიაპაზონის პასუხის კოდი შემდეგ XML ფორმატირებულ კონტენტთან ერთად:
უარყოფითი აღიარება, NAK, მიწოდების ანგარიში არ არის მიწოდებული:
ნებისმიერი პასუხი, გარდა დადებითი აღიარებისა, მაგampასევე, უარყოფითი აღიარება გამოწვეულია ნებისმიერი HTTP შეცდომის კოდით ან შემდეგი XML შინაარსით:
XML კონტენტი შეიძლება გამოყენებულ იქნას LINK Mobility განმეორებითი ცდის მექანიზმის გასაკონტროლებლად. NAK გამოიწვევს ხელახლა ცდის მცდელობას, თუ ჩართულია. სერვისის პროვაიდერებისთვის, რომლებიც არ არის კონფიგურირებული ხელახალი ცდის მექანიზმისთვის, XML კონტენტი არჩევითია.
ქვემოთ მოცემულია HTTP POST მოთხოვნა და პასუხი მაგampსერვისის პროვაიდერისთვის მიწოდებული მიწოდების ანგარიში:
HTTP მოთხოვნა:
POST /კონტექსტი/აპი HTTP/1.1
შინაარსის ტიპი: განცხადება / x-www- ფორმა-urlკოდირებული;charset=utf-8
მასპინძელი: სერვერი: პორტი
შინაარსი-სიგრძე: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
HTTP პასუხი:
HTTP/1.1 200 OK
შინაარსი-ტიპი: ტექსტი/უბრალო
9.2 ხელახლა სცადეთ
LINK Mobility სისტემას შეუძლია განახორციელოს განმეორებითი მცდელობები წარუმატებელი, ანუ დაუდასტურებელი მიწოდების ანგარიშის მიწოდებისთვის. სერვისის პროვაიდერს შეუძლია აირჩიოს ხელახალი ცდის სასურველი ქცევა:
ხელახლა ცდა არ არის (ნაგულისხმევი) – შეტყობინება გაუქმდება, თუ კავშირის მცდელობა ვერ მოხერხდა, წაკითხვის დრო ამოიწურა ან რაიმე HTTP შეცდომის კოდი.
ხელახლა სცადეთ – შეტყობინება ხელახლა გაიგზავნება ყველა ტიპის კავშირის პრობლემის, წაკითხვის დროის ამოწურვის ან უარყოფითი აღიარებისთვის.
როდესაც NAK-ის ხელახალი ცდა ჩართულია, მნიშვნელოვანია გვესმოდეს, თუ რომელი სცენარები წარმოქმნის ხელახლა ცდას LINK Mobility-დან და როგორ მუშაობს ხელახალი ცდა. თითოეულ სერვის პროვაიდერს აქვს საკუთარი განმეორებითი რიგი, სადაც შეტყობინებები წესრიგდება შეტყობინების დროის დროის მიხედვითamp. Link Mobility ყოველთვის ცდილობს პირველ რიგში ძველი შეტყობინებების მიწოდებას, მიუხედავად იმისა, რომ სერვისის პროვაიდერისთვის მიწოდებული შეტყობინებების ინდივიდუალური თანმიმდევრობა გარანტირებული არ არის. განმეორებითი ცდის რიგიდან შეტყობინებების გაუქმების მთავარი მიზეზი არის ორიდან ერთ-ერთი: ან შეტყობინება TTL იწურება ან (თეორიულად) განმეორებითი ცდის რიგი სავსეა. TTL არის ოპერატორზე და დამოკიდებულია ანგარიშზე, ანუ, შეიძლება განსხვავდებოდეს ოპერატორის და ან შეტყობინების ტიპის მიხედვით, მაგ., პრემიუმ SMS ან სტანდარტული ტარიფის SMS შეტყობინება.
სერვისის პროვაიდერებმა ჩართული ხელახალი ცდა უნდა შეამოწმონ MT შეტყობინების უნიკალური ID, რათა უზრუნველყონ, რომ შეტყობინება უკვე მიღებული არ არის.
მნიშვნელოვანია, რომ სერვისის პროვაიდერმა დაიცვას ეს მარტივი წესები, როდესაც შეცდომა ხდება მიწოდების ანგარიშის დამუშავებისას, თუ შეცდომის მიზეზი არის: დროებითი, მაგ. მონაცემთა ბაზა მიუწვდომელია, NAK უნდა დაბრუნდეს. LINK Mobility ხელახლა გამოგიგზავნით შეტყობინებას.
მუდმივი და ხელახალი მცდელობა, სავარაუდოდ, გამოიწვევს იგივე სახის პრობლემას, ACK უნდა დაბრუნდეს. მაგample, როდესაც შეტყობინების სწორად გაანალიზება ვერ მოხერხდა ან გამოიწვია გაშვების დროს მოულოდნელი შეცდომა.
შესაბამისად მოქმედება უზრუნველყოფს, რომ არ მოხდეს დაბლოკვა ან გამტარუნარიანობის დეგრადაცია მიწოდების ანგარიშის განმეორებით გაგზავნის გამო.
10. განხორციელების რჩევები
1. შესაძლებელია გამოიყენოთ თქვენი web ბრაუზერი API-ზე მოთხოვნების გასაგზავნად. ეს ძალიან აადვილებს სერვისების შესწავლას და შეფასებას განვითარების ინსტრუმენტების გარეშე.
2. Chrome ან Firefox რეკომენდებულია გაფართოებასთან ერთად, როგორიცაა JSONView ლამაზად ფორმატირებული JSON საჩვენებლად.
3. ჩვენ გამოვიყენეთ SoapUI POST-ის, ძირითადი ავთენტიფიკაციის შესამოწმებლად და დაუმუშავებელი HTTP მოთხოვნისა და პასუხების შეტყობინებების შესამოწმებლად.
4. ქURL ინსტრუმენტი სასარგებლოა ძირითადი ავთენტიფიკაციით POST მოთხოვნის წარდგენისთვის. იხampქვემოთ.
curl პოსტი \
-H “შინაარსის ტიპი: განაცხადი/x-www-ფორმა-urlკოდირებული” \
-H “ავტორიზაცია: ძირითადი am9objpjaGFuZ2VtZSA=” \
https://europe.ipx.com/restapi/v1/sms/send \
–მონაცემები „destinationAddress=46123456789&messageText=Hello+World%21“
_______________
პერსონალიზებული კომუნიკაციების ტრანსფორმაცია
დოკუმენტები / რესურსები
 |
LINK Mobility დანერგვის სახელმძღვანელო REST API SMS [pdf] მომხმარებლის სახელმძღვანელო Mobility Implementation Guide REST API SMS, Mobility, Implementation Guide REST API SMS, REST API SMS, API SMS, SMS |
