발신 팩스 작업 목록 조회

발신 팩스 작업 목록 조회

활성화된 MultiTEL API 계정을 사용하고, 설정된 인증 정보와 IP 제한을 적용하여 HTTPS로 접속하세요. 이 엔드포인트는 인증된 계정에 속한 발신 팩스 기록을 나열합니다. 목록을 조회해도 팩스가 전송되거나 재전송되지 않습니다.

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 요청에 그대로 사용하면 안 됩니다. 결과는 생성 시각을 기준으로 최신 항목부터 정렬되며, ID를 이용한 보조 정렬이나 스냅샷 커서는 없습니다.

작업 기록 확인

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는 숫자 형식의 기록 ID입니다. uuid는 화면에 표시되는 작업 식별자입니다. 새로 전송할 때는 send_fax에서 반환한 작업 ID를 사용하고, 이 ID를 보관하여 상태 폴링에 사용하세요. 목록에는 이전 기록도 포함될 수 있으므로, 모든 행이 동일한 전송 엔드포인트를 통해 생성되었다고 가정하지 마세요.

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에 따라 페이지를 조회하세요. 마지막 페이지를 넘어서면 빈 페이지가 반환될 수 있습니다. 조회 중에 새 작업이 추가되면 항목이 다른 페이지로 이동할 수 있습니다. 여러 페이지의 결과를 합칠 때는 작업 식별자를 유지하세요. 이 엔드포인트는 고정된 스냅샷을 보장하지 않습니다.

개인정보 보호 및 재시도

보낸 팩스함 기록에는 비공개 전화 메타데이터가 포함되어 있습니다. 기록을 읽을 수 있는 사용자를 제한하고 응답 전체를 로그에 남기지 마세요. 목록에 항목이 없다고 해서 전송 요청이 실패했다는 뜻은 아닙니다. 다시 전송하기 전에 보관한 작업 ID와 포털의 보낸 팩스함을 확인하세요. 새로 전송하면 과금 대상이 될 수 있는 또 다른 팩스가 생성될 수 있습니다. 백그라운드 작업 프로세스의 처리, 과금, 콜백 및 데이터 보존에 대한 최종 보장 사항은 아직 검토 중입니다.