팩스 작업 상태 확인

내 작업 조회

활성화된 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는 이 계정에서 작업을 찾지 못했음을 뜻합니다. 식별자만으로 소유권을 추론하지 마세요.