HTTPS와 승인된 API 자격 증명을 사용한 HTTP Basic 인증을 사용하세요. 자격 증명은 애플리케이션 서버에 보관하세요. 이러한 호스팅 PBX 엔드포인트는 api.multitel.net에서 /hpbx/을(를) 사용하며, /v3은(는) 삽입하지 마세요. HTTP 결과와 JSON 응답의 애플리케이션 수준의 처리 결과 상태를 모두 확인하세요.
팩스 기록 읽기
curl --request POST --user "USERNAME:PASSWORD" \
"https://api.multitel.net/hpbx/fax/list/YOUR_BILLING_CODE"청구 코드를 해당 PBX의 코드로 교체하십시오. 반환된 기록에는 팩스 시간, 방향, 발신지, 수신지, 전달 상태, 시도 횟수, 오류 및 페이지 수가 포함됩니다. 발송 요청이 수락된 경우에도 전달 상태가 보류 중일 수 있습니다.
전송 매개변수
전송 엔드포인트는 POST /hpbx/fax/send/{billing_code}입니다. 전송은 실제로 실행되는 작업입니다. 제출하기 전에 파일과 계정에서 허용된 목적지를 준비하십시오. 결과가 불확실한 전송은 무작정 다시 시도하지 마십시오.
| 필드 | 의미 |
|---|---|
| number | 수신 팩스 번호. |
| cidnum | 발신에 사용하도록 승인된 발신자 번호. |
| schedule | 예약 전송 시간(사용하는 경우). |
| faxquality / pagesize / pagerotate | 지원되는 품질, 용지 크기 및 회전 옵션. |
| statusemail | 전송 결과 알림에 사용하도록 허용된 주소. |
| deleteaftersend | 발송 후 저장된 업로드 파일을 삭제할지 여부. |
| filename | 이 팩스 워크플로가 요구하는 문서 참조입니다. 임의의 로컬 파일 경로가 아닙니다. |
완료 여부 추적
제출 후 팩스 기록의 상태, 시도 횟수 및 오류를 확인하십시오. 접수를 전송 완료로 해석하지 말고 전송 완료를 확인하십시오. 포털 팩스 참조 문서에는 현재 업로드 및 발송 워크플로가 설명되어 있으며, 그 경로와 인증은 위의 엔드포인트와 별개입니다.