REST API დოკუმენტაცია

სატელეფონო ნომრების REST API-ები

აღმოაჩინეთ ხელმისაწვდომი ქვეყნები და ნომრები, შეისწავლეთ შეთავაზება სრულად და მართეთ თქვენი ნომრები.

თქვენი ანგარიშისთვის განკუთვნილი ცნობარის გახსნა დეველოპერები და ავტომატიზაცია

API და მისი ავტორიზაციის მონაცემები ერთად შეარჩიეთ

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

API ოჯახი	საბაზო URL	ავთენტიფიკაცია და შედეგი
კომუნიკაციები v3	`https://api.multitel.net/v3`	დამტკიცებული Basic ავტორიზაციის მონაცემები; სპეციალურად გაცემული შესაბამისი ტოკენები მხოლოდ იმ ოპერაციებისთვის, რომლებიც მათ მხარს უჭერს. JSON `status` და `response`.
გადაუდებელი დახმარების სერვისში რეგისტრაცია	`https://api.multi.tel/emergency`	დამტკიცებული Basic ავტორიზაციის მონაცემები ან სპეციალურად ჩართული bearer წვდომა. JSON `code`, `message` და `data`.
პორტალის REST ინტეგრაციები	ჰოსტი და ოპერაცია ნაჩვენებია თქვენი ანგარიშის დეველოპერის ცნობარში	გამოიყენეთ კონკრეტული ოპერაციისთვის დოკუმენტირებული ავტორიზაციის მონაცემები, ნებართვის ფარგლები და სქემა. ბრაუზერის სესიის მოთხოვნები ცალკე ინტერფეისს განეკუთვნება.

მაგალითების გამოყენებამდე MULTITEL_API_USERNAME და MULTITEL_API_PASSWORD თქვენი სერვერის საიდუმლო კონფიგურაციის მეშვეობით დააყენეთ. არასოდეს ჩასვათ ისინი ბრაუზერის საჯარო JavaScript-ში, URL-ებში ან კოდის ვერსიების საცავში. სპეციალური ავტორიზაციის მონაცემები API ინტეგრაციის პარამეტრებში იმართება.

ხელმისაწვდომი ქვეყნების კატალოგის წაკითხვა

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

v3 პასუხი შეიცავს status-ს და response მასივს. ქვეყნის ჩანაწერები შეიცავს isocode-ს, name-ს, countrycode-ს, შესაძლებლობების ინფორმაციასა და next_function-ს. ხელმისაწვდომობა დამოკიდებულია ანგარიშსა და მარაგზე; ქვეყანა არ არის გარანტია, რომ ყველა პრეფიქსი ან ნომრის ტიპი მარაგშია.

{
  "status": {
    "code": 200,
    "msg": "Results: 1"
  },
  "response": [
    {
      "countrycode": "1",
      "name": "United States",
      "description": "United States",
      "isocode": "US",
      "is_mobile": 0,
      "sms_coverage": 1,
      "latitude": "37.0902",
      "longitude": "-95.7129",
      "next_function": "v3/getareas/US"
    }
  ]
}

აღმოჩენიდან აქტივაციამდე

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

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

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

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

იდემპოტენტურობის მხარდაჭერა API-ის თითოეულ ოჯახზეა დამოკიდებული. Emergency API განმეორებითი მცდელობების გასაღებებს უჭერს მხარს; ეს არ ნიშნავს, რომ ყველა v3 მოთხოვნა იდემპოტენტურია. მხარდაჭერისთვის შეინახეთ დროის ნიშნულები, დაბრუნებული ID-ები და პასუხები, საიდანაც საიდუმლო მონაცემები ამოღებულია.

გააგრძელეთ თქვენი ანგარიშის საცნობარო მასალით

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

თქვენი ანგარიშისთვის განკუთვნილი ენდპოინტების კატალოგი კომუნიკაციების REST კონსოლი კომუნიკაციების საჯარო OpenAPI დოკუმენტი OAuth ინტეგრაციის სახელმძღვანელო