사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
카카오모먼트
광고계정 관리
이 문서는 광고계정 관리 API 사용 방법을 안내합니다.
| 메서드 | URL | 인증 방식 |
|---|---|---|
GET | https://apis.moment.kakao.com/openapi/v4/companies | 비즈니스 토큰 |
사업자 정보를 조회합니다.
비즈니스 토큰을 헤더에 담아 GET으로 요청합니다. 조회할 사업자의 사업자등록번호를 파라미터로 전달해야 합니다. 실패 시 에러 코드에서 원인을 확인합니다.
| 이름 | 설명 | 필수 |
|---|---|---|
| Authorization | Authorization: Bearer ${BUSINESS_ACCESS_TOKEN}인증 방식, 비즈니스 토큰으로 인증 요청 | 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}"
응답
{"id": 680,"businessRegistrationNumber": "123-12-12345","name": "주식회사 사업자","representationName": "사업자대표","businessCategory": "서비스","businessItem": "서비스","address": {"zipCode": "13494","baseAddress": "경기 성남시 분당구 판교역로 235","detailAddress": "H스퀘어"}}