개요
이 가이드는 Fax.Plus API를 통해 fax 번호를 기업 사용자에게 할당하는 방법을 설명합니다. 기업 회원 목록을 조회하고, 특정 사용자에게 번호를 할당하고, 필요할 때 번호 할당을 해제하는 방법을 배우게 됩니다.
사전 준비 사항
- 활성화된 Fax.Plus Enterprise 계정
- 유효한 API 자격 증명
- 계정에 두 개 이상의 fax 번호
단계별 가이드
-
기업 회원 목록 조회
먼저 기업 계정의 모든 회원 목록을 조회합니다. 이 엔드포인트는 관리자 계정만 접근할 수 있습니다.GET /v3/accounts{중요: 번호를 할당할 회원의
"members": [
{
"account_data": {
"company_name": "Company name",
"default_file_type": "pdf",
"save_history": true
},
"account_type": "corporate_admin",
"email": "John@sample.com",
"lastname": "Smith",
"status": "active",
"uid": "7724157c0974440293e45877c57f0703"
}
]
}UID를 기록해 두세요. 다음 단계에서 필요합니다.
자세히 알아보기: 기업 회원 목록 조회 - Fax.Plus API -
사용자에게 번호 할당
사용자의UIU를 확인한 후에는 다음 엔드포인트를 사용하여 fax 번호를 할당할 수 있습니다.POST /v3/accounts/self/numbers/{number}
요청 본문:{URL의
"assigned_to": "<uid>"
}{number}를 할당하려는 실제 fax 번호로 바꾸고,assigned_to값을 사용자의UIU로 바꾸세요.
자세히 알아보기: 번호 할당 - Fax.Plus API - 번호 할당 해제
사용자로부터 번호 할당을 제거해야 하는 경우 다음 엔드포인트를 사용하세요:DELETE /v3/accounts/{user_id}/numbers/{number}
자세히 알아보기: 번호 할당 해제 - Fax.Plus API
매개변수:
-
user_id번호를 할당 해제할 사용자의 ID -
number사용자로부터 제거할 fax 번호
-
문제 해결
일반적인 문제 및 해결 방법
-
403 금지됨 오류
- 원인: 권한 부족 또는 관리자가 아닌 계정
- 해결 방법: 관리자 계정을 사용하고 있는지, 필요한 API 범위를 보유하고 있는지 확인하세요
-
404 찾을 수 없음 오류
- 원인: 잘못된 사용자 ID 또는 fax 번호
- 해결 방법: 사용자 ID와 fax 번호가 올바른지 다시 확인하세요
-
400 잘못된 요청 오류
- 원인: 잘못된 요청 형식이거나 관리자로부터 번호를 제거하려고 시도함
- 해결 방법: 요청 형식을 확인하고 관리자 계정에서 번호를 제거하려고 하지 않는지 확인하세요