수신 팩스 목록 조회

활성화된 MultiTEL API 계정을 사용하고, 설정된 인증 정보와 IP 제한을 적용하여 HTTPS로 연결하세요. 이 엔드포인트는 인증된 계정에 속한 수신 팩스 목록을 반환합니다. 팩스를 보내거나 팩스 문서를 다운로드하지는 않습니다.

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

수신함 쿼리 매개변수
매개변수	필수 여부	설명
`page`	아니요	1부터 시작하는 페이지 번호입니다. 기본값: 1.
`limit`	아니요	페이지당 레코드 수입니다. 기본값: 25, 최댓값: 100. 양의 정수를 사용하세요.
`search`	아니요	발신 번호, 수신 팩스 번호 및 상대 팩스 장치 식별자를 검색합니다. 앞뒤 공백은 제거됩니다. 대소문자 구분 여부는 데이터베이스의 데이터 정렬 설정에 따라 달라집니다.
`date_from`	아니요	서버 현지 시간으로 지정한 날짜의 시작 시점부터 수신한 팩스를 포함합니다. YYYY-MM-DD 형식을 사용하세요.
`date_to`	아니요	서버 현지 시간으로 지정한 날짜의 종료 시점까지 수신한 팩스를 포함합니다. YYYY-MM-DD 형식을 사용하세요.

날짜 범위에는 양 끝 날짜가 포함되며, 요청된 사용자 시간대가 아닌 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는 수신함 레코드의 숫자형 ID입니다. hash는 기존 수신 문서 처리 절차에 사용하는 해당 ID의 MD5 표현입니다. send_fax 작업 ID나 권한 확인용 인증 정보가 아닙니다. 발신용 fax_status 엔드포인트에 사용하지 마세요.

received_timestamp는 저장된 유닉스 타임스탬프입니다. received_at은 시간대 오프셋 없이 서버에서 형식을 지정한 타임스탬프이며, 수신 시각이 기록되지 않았다면 null입니다. 사용하는 시간대로 시각을 표시할 때는 유닉스 값을 사용하세요. cost는 JSON 숫자이며, 견적 가격이나 별도의 과금이 완료되었다는 증거가 아닙니다.

status는 저장된 상태 코드가 영일 때만 success가 되며, 그 외의 값은 failed가 됩니다. status_text에는 저장된 처리 메시지가 담기며, 대체 값으로 OK 또는 Failed를 사용합니다. emailed는 불리언이 아닌 저장된 값을 그대로 유지합니다. viewed는 불리언입니다. 팩스 상태만으로 이메일이 성공적으로 전달되었다고 판단하지 마세요.

비어 있거나 변경되는 목록 처리

수신함이 비어 있으면 빈 faxes 배열과 값이 0인 total, 값이 0인 total_pages가 반환됩니다. 마지막 페이지를 넘어선 페이지를 요청해도 빈 배열이 반환될 수 있습니다. 페이지가 적어도 하나는 있다고 가정하지 말고 페이지 나누기 필드에 따라 조회를 중단하세요. 커서나 레코드 ID를 기준으로 하는 보조 정렬은 제공되지 않습니다. 페이지 간에 겹치는 항목을 대조할 때는 레코드 ID를 보관하세요.

문서 접근 및 개인정보 보호

수신함 항목에는 비공개 전화 정보와 문서 메타데이터가 포함됩니다. 애플리케이션에서 접근을 제한하고 응답 전체를 로그에 기록하지 마세요. 목록을 조회해도 문서가 열람한 것으로 표시되지는 않습니다. 호환성을 위한 수신 문서 다운로드에는 fax_file을 사용하세요. 다만 파일을 사용할 수 없더라도 기존 수신 레코드가 열람한 것으로 표시된다는 점에 유의하세요. 포털 수신함에서도 문서에 접근할 수 있습니다. 파일 보관에 대한 보장은 확립되어 있지 않습니다.