მიღებული ფაქსების ჩამონათვალი

მიღებული ფაქსების ჩამონათვალი

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

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode date_from=2026-10-01 \
  --data-urlencode date_to=2026-10-02 \
  https://api.multitel.net/v3/fax_inbox

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

საფოსტო ყუთის გვერდის წაკითხვა

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

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 12,
      "hash": "c20ad4d76fe97759aa27a0c99bff6710",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "remote_station_id": "Example sender",
      "pages": 2,
      "cost": 0.05,
      "received_at": "2026-10-01 12:00:00",
      "received_timestamp": 1790856000,
      "status": "success",
      "status_text": "OK",
      "emailed": "yes",
      "viewed": false
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

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

received_timestamp არის შენახული Unix დროის ნიშნული. received_at არის სერვერის მიერ ფორმატირებული დროის ნიშნული დროის სარტყლის წანაცვლების გარეშე, ან null, თუ მიღების დრო არ არის ჩაწერილი; თქვენს დროის სარტყელში დროის საჩვენებლად გამოიყენეთ Unix მნიშვნელობა. cost არის JSON რიცხვი და არა ფასის შეთავაზება ან ცალკე შესრულებული თანხის ჩამოჭრის დასტური.

status იღებს success მნიშვნელობას მხოლოდ მაშინ, როცა შენახული სტატუსის კოდი ნულია; სხვა მნიშვნელობები გარდაიქმნება failed მნიშვნელობად. status_text შეიცავს დამუშავების შენახულ შეტყობინებას; მისი არარსებობისას გამოიყენება OK ან Failed. emailed ინარჩუნებს შენახულ მნიშვნელობას და არ გარდაქმნის მას ლოგიკურ მნიშვნელობად. viewed არის ლოგიკური მნიშვნელობა. მხოლოდ ფაქსის სტატუსის საფუძველზე ნუ დაასკვნით, რომ ელფოსტა წარმატებით იქნა მიწოდებული.

ცარიელი და ცვალებადი სიების დამუშავება

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

დოკუმენტებზე წვდომა და კონფიდენციალურობა

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