ფაქსის დავალების სტატუსის შემოწმება

მოძებნეთ თქვენი დავალება

გამოიყენეთ ჩართული MultiTEL API ანგარიში. პაროლიანი ანგარიშისთვის გაგზავნეთ HTTP Basic ავტორიზაციის მონაცემები, ხოლო ტოკენიანი ანგარიშისთვის — Bearer ტოკენი. ანგარიშის ნებართვები და IP შეზღუდვები კვლავ მოქმედებს. არ გამოიყენოთ დამუშავების პროცესის შიდა ავტორიზაციის მონაცემები.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id სავალდებულოა და უნდა იყოს send_fax-ის მიერ დაბრუნებული 32-სიმბოლოიანი თექვსმეტობითი იდენტიფიკატორი. ზუსტად დააკოპირეთ. მოთხოვნები შეზღუდულია ავთენტიფიცირებული მფლობელით.

წაიკითხეთ შედეგი

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

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

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

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

შეცდომები

API კოდი 400 ნიშნავს, რომ job_id აკლია ან არასწორი ფორმატითაა; 401 ნიშნავს ავთენტიფიკაციის არქონას; 404 ნიშნავს, რომ ამ ანგარიშისთვის დავალება ვერ მოიძებნა. მხოლოდ იდენტიფიკატორიდან მფლობელობას ნუ დაასკვნით.