ნომრების პორტირების პროექტის სტატუსის შემოწმება

ანგარიშსა და პროექტზე წვდომა

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

მოთხოვნა

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/status"

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

პასუხი

პასუხის გამოგონილი მაგალითი.

{
  "status": {
    "code": 200,
    "msg": "Project Status"
  },
  "response": {
    "uniqueid": "PROJECT_EXAMPLE",
    "status": 2,
    "status_str": "Completed",
    "counts": {
      "total": 2,
      "pending": 0,
      "in_progress": 0,
      "completed": 1,
      "rejected": 1
    }
  }
}

გარე ველი status.code აჩვენებს API მოთხოვნის შედეგს. ცალკე ველი response.status წარმოადგენს პროექტის მონაცემებიდან გამოთვლილ პორტირების შეჯამებას. ეს ორი ერთმანეთში არ აგერიოთ.

შეჯამება ყველა ნომრის შედეგს არ ასახავს

შეჯამება ირჩევს In Progress მნიშვნელობას, თუ რომელიმე ნომერს ეს სტატუსი აქვს; წინააღმდეგ შემთხვევაში — Pending, შემდეგ — Completed, შემდეგ კი — Rejected. თუ არცერთი ცნობილი სტატუსი არ ემთხვევა, ნაგულისხმევად აირჩევა Pending. ამიტომ პროექტი, რომელიც შეიცავს როგორც დასრულებული, ისე უარყოფილი პორტირების მქონე ნომრებს, აჩვენებს Completed მნიშვნელობას, მიუხედავად იმისა, რომ მასში უარყოფილი ნომრები კვლავ არის.

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

პორტირების სტატუსის განმარტება

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

შეცდომები და შეზღუდვები

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

მოქმედების შედეგები

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