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

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

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

მოთხოვნა

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

პასუხი

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

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

response სიაა. არსებული პროექტი, რომელსაც ნომრები არ აქვს, აბრუნებს ცარიელ სიას API კოდით 200 და status.results-ის მნიშვნელობით 0. არარსებული პროექტები კი აბრუნებს API კოდს 404.

ნომრის ველები

პორტირებადი ნომრის ველები
ველი	მნიშვნელობა
id, number, isocode	ჩანაწერის რიცხვითი ID, შენახული ტელეფონის ნომრის ტექსტი და ქვეყნის კოდი. ჩანაწერის ID პროექტის ID არ არის.
status, status_str	რიცხვითი სტატუსი და მისი ცნობილი დასახელება.
foc	შენახული საბოლოო შეკვეთის დადასტურების დაგეგმვის მნიშვნელობა. ის შეიძლება ცარიელი იყოს; დამმუშავებელი მას დოკუმენტირებულ დროის სარტყლად ან დროის ნიშნულის ფორმატად არ გარდაქმნის.
updated, date_created, date_completed	განახლების, შექმნისა და დასრულების შენახული მნიშვნელობები. ცარიელი მნიშვნელობები აშკარად დაამუშავეთ; არ ივარაუდოთ ISO8601 და გამოგონილი მაგალითიდან დროის სარტყვის შესახებ დასკვნას ნუ გამოიტანთ.
comment	მომხმარებლისთვის განკუთვნილი შენახული კომენტარი. აჩვენეთ ტექსტად და არა შესრულებად HTML-ად.

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

დალაგება და მონიტორინგი

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

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

ნომრის სტატუსის ცნობილი მნიშვნელობები
მნიშვნელობა	დასახელება
0	Pending
1	In Progress
2	Completed
9	Rejected

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

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

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

ზემოქმედება

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