3. 정보확인
3.1. GetFaxResult - 전송내역 확인 (접수번호)
- 팝빌에서 반환 받은 접수번호를 통해 팩스 전송상태 및 결과를 확인합니다.
def getFaxResult(CorpNum, ReceiptNum, UserID=None):Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| ReceiptNum | str | 18 | Y | 팩스 전송요청시 발급받은 접수번호 | |
| UserID | str | 50 | N | 팝빌회원 아이디 |
Return
Throws
3.2. GetFaxResultRN - 전송내역 확인 (요청번호)
- 파트너가 할당한 요청번호를 통해 팩스 전송상태 및 결과를 확인합니다.
def getFaxResultRN(CorpNum, RequestNum, UserID=None):Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| RequestNum | str | 36 | Y | 팩스 전송요청시 파트너가 할당한 요청번호 | |
| UserID | str | 50 | N | 팝빌회원 아이디 |
Return
Throws
3.3. Search - 전송내역 목록 조회
-
검색조건에 해당하는 팩스 전송내역 목록을 조회합니다. (조회기간 단위 : 최대 2개월)
※ 팩스 접수일시로부터 2개월 이내 접수건만 조회할 수 있습니다.
def search(CorpNum, SDate, EDate, State, ReserveYN, SenderOnly, Page, PerPage, Order, UserID=None, QString=None):- 매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| SDate | str | 8 | Y |
조회 기간의 시작일자
형식 : yyyyMMdd
|
|
| EDate | str | 8 | Y |
조회 기간의 종료일자
형식 : yyyyMMdd
|
|
| State | list | N |
전송상태 (다중 선택 가능)
기본값 : 전체조회
|
||
| ReserveYN | bool | - | N |
예약여부
true예약전송건
false즉시전송건
기본값 : 전체조회
|
|
| SenderOnly | bool | - | N |
개인조회 여부
True해당 담당자 계정으로 접수한 팩스만 조회 (개인권한)
False접수한 팩스 전체 조회 (관리자권한) : 기본값
|
|
| Page | int | - | N |
목록 페이지번호
기본값 : 1
|
|
| PerPage | int | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
| Order | str | 1 | N |
팩스 접수일시를 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
|
|
| UserID | str | 50 | N | 팝빌회원 아이디 | |
| QString | str | - | N |
조회 검색어(발신자명/수신자명)
기본값 : 전체조회
|
|
Return
Throws
3.4. GetSentListURL - 팩스 전송내역 팝업 URL
- 팩스 전송내역 팝업 URL을 반환합니다.
- 권장 사이즈 : width = 1,361px / height = 684px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
def getSentListURL(CorpNum, UserID):Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | str | 50 | N | 팝빌회원 아이디 |
Return
str - 요청에 대한 응답 URL
Throws
3.5. GetPreviewURL - 팩스 변환파일 확인 팝업 URL
- 팩스 1건의 변환파일을 확인하는 팝업 URL을 반환합니다.
- 권장 사이즈 : width = 1,058px / height = 887px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.
def getPreviewURL(CorpNum, ReceiptNum, UserID):Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| corpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| ReceiptNum | str | 18 | Y | 팩스 전송요청시 팝빌로부터 반환 받은 접수번호 | |
| UserID | str | 50 | N | 팝빌회원 아이디 |
Return
str - 요청에 대한 응답 URL