이 문서는 광고계정 관리 API 사용 방법을 안내합니다.
메서드 | URL | 인증 방식 |
---|---|---|
GET |
https://apis.moment.kakao.com/openapi/v4/companies |
비즈니스 토큰 |
권한 | 사전 설정 | 비즈니스 인증 | 비즈니스 동의항목 |
---|---|---|---|
필요: 사용 권한 신청 | 비즈 앱 전환 비즈니스 Redirect URI 등록 비즈니스 동의항목 |
필요 | 필요 |
사업자 정보를 조회합니다.
비즈니스 토큰과 광고계정 ID(adAccountId
)를 헤더에 담아 GET
으로 요청합니다. 조회할 사업자의 사업자등록번호를 파라미터로 전달해야 합니다. 실패 시 에러 코드 및 상세 에러 코드로 사유를 확인합니다.
이름 | 설명 | 필수 |
---|---|---|
Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN} 인증 방식, 비즈니스 토큰으로 인증 요청 |
O |
adAccountId | adAccountId: ${AD_ACCOUNT_ID} 광고계정 ID |
O |
이름 | 타입 | 설명 | 필수 |
---|---|---|---|
bizNum | String |
사업자등록번호 | O |
이름 | 타입 | 설명 |
---|---|---|
id | Long |
사업자 번호 |
businessRegistrationNumber | String |
사업자등록번호 |
name | String |
사업자 |
representationName | String |
대표자 |
address | Address |
주소 |
businessCategory | String |
업태 |
businessItem | String |
종목 |
이름 | 타입 | 설명 |
---|---|---|
baseAddress | String |
기본주소 |
detailAddress | String |
상세주소 |
zipCode | String |
우편번호 |
curl -X GET "https://apis.moment.kakao.com/openapi/v4/companies?bizNum=120-81-47521" \
-H "Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}" \
-H "adAccountId: ${AD_ACCOUNT_ID}"
{
"id": 680,
"businessRegistrationNumber": "123-12-12345",
"name": "주식회사 사업자",
"representationName": "사업자대표",
"businessCategory": "서비스",
"businessItem": "서비스",
"address": {
"zipCode": "13494",
"baseAddress": "경기 성남시 분당구 판교역로 235",
"detailAddress": "H스퀘어"
}
}