გამავალი ფაქსის დავალებების სიის ნახვა

გამავალი ფაქსის დავალებების სიის ნახვა

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

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

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

დავალებების ჩანაწერების წაკითხვა

წაიკითხეთ როგორც HTTP შედეგი, ისე JSON პასუხის status.code ველი. წარმატებული პასუხი შეიცავს response.faxes და response.pagination ველებს; მაგალითში გამოყენებულია გამოგონილი მონაცემები. ცარიელი საფოსტო ყუთისთვის ბრუნდება ცარიელი faxes მასივი, სადაც total არის 0, ხოლო total_pages არის 0.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

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

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

pages_requested და pages_sent რაოდენობების რიცხვითი მაჩვენებლებია. cost ინარჩუნებს შენახულ მნიშვნელობას, ხოლო სათადარიგო მნიშვნელობად გამოიყენება სტრიქონი 0.00; ნუ ჩათვლით, რომ მას იგივე JSON ტიპი აქვს, რაც შემომავალი ფაქსების ღირებულებას. რიგში მყოფი დავალების ჩანაწერი შეიძლება უკვე შეიცავდეს სავარაუდო ღირებულებას. არც ეს მნიშვნელობა და არც სიაში ჩანაწერის არსებობა არ ადასტურებს საბოლოო დარიცხვას.

created_at, sent_at და updated_at სერვერის ფორმატით შენახული მნიშვნელობებია დროის სარტყლის წანაცვლების გარეშე; sent_at შეიძლება იყოს null. სიაში არ შედის ვებჰუკის სტატუსის ველი, რომელსაც სტატუსის ცალკე წვდომის წერტილი აბრუნებს.

გვერდების უსაფრთხოდ შეჯერება

იხელმძღვანელეთ pagination.page, limit, total და total_pages ველებით. ბოლო გვერდის შემდეგ მოთხოვნილი გვერდები შეიძლება ცარიელი იყოს. დათვალიერებისას ახალმა დავალებებმა შეიძლება ჩანაწერების გვერდებს შორის გადანაცვლება გამოიწვიოს. გვერდების გაერთიანებისას შეინახეთ დავალებების იდენტიფიკატორები; ეს წვდომის წერტილი მონაცემთა სტაბილური მომენტალური ასლის გარანტიას არ იძლევა.

კონფიდენციალურობა და განმეორებითი მცდელობები

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