ნომრების პორტირების პროექტის მოვლენების წაკითხვა

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

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

მოთხოვნა

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

პასუხი

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

{
  "status": {
    "code": 200,
    "msg": "Project Events",
    "results": 1
  },
  "response": [
    {
      "id": 31,
      "subject": "Example project update",
      "event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
      "type": "comment",
      "value": "Example update",
      "source": "Example source",
      "date_created": "2026-10-23 12:00:00"
    }
  ]
}

არსებული პროექტისთვის, რომელსაც მოვლენები არ აქვს, ბრუნდება API კოდი 200, ცარიელი სია და status.results უდრის 0-ს. შედეგები მოითხოვება შექმნის დროის კლებადობით; ერთნაირი დროის მქონე შედეგებისთვის დამატებითი დალაგება, გვერდებად დაყოფა, კურსორი ან თარიღის ფილტრი არ არის გათვალისწინებული.

ყურადღებით წაიკითხეთ მოვლენის მონაცემები

id არის მოვლენის ჩანაწერის რიცხვითი იდენტიფიკატორი, subject არის მისი შენახული თემა, ხოლო date_created არის მისი შენახული თარიღისა და დროის მნიშვნელობა. ეს წვდომის წერტილი უცვლელად ინახავს დაუმუშავებელ event სტრიქონს და ასევე ცდილობს გაშიფროს მისი ველები: type, value და source. თუ მონაცემები არ არის JSON ობიექტი ან რომელიმე თვისება აკლია, გარჩევის შედეგად მიღებული შესაბამისი ველი ცარიელი სტრიქონია.

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

ისტორია მიწოდების გარანტია არ არის

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

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

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

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

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