사이드 메뉴
커뮤니케이션
API 제공
어드민 API
개발자 계정 관리
이 문서는 제공 종료된 구버전 어드민 API에 대해 안내합니다. 신규 어드민 API에 대한 자세한 내용은 신규 어드민 API 제공 안내에서 확인할 수 있습니다.
이 문서는 카카오디벨로퍼스 개발자 계정에 대한 어드민 API 사용 방법을 안내합니다.
각 제목에 부착된 태그(Tag)는 아래와 같은 의미입니다.
| 태그 | 설명 |
|---|---|
Internal | 이 액션은 API플랫폼 내부에서만 사용합니다. |
| 메서드 | 호스트 | 리소스 |
|---|---|---|
POST | internal-admin-kapi.kakao.com | /developer |
| 이름 | 설명 |
|---|---|
| FIND_BY_EMAIL Internal | 이메일로 개발자 계정을 조회합니다. |
| FIND_BY_ACCOUNT_ID | 카카오계정 ID로 개발자 계정을 조회합니다. |
| FIND_STATUS_BY_ACCOUNT_ID | 카카오계정 ID로 개발자 계정 상태를 조회합니다. |
| IS_REGISTERED_BY_EMAIL Internal | 주어진 이메일로 등록된 개발자 계정이 존재하는지 조회합니다. |
| IS_REGISTERED_BY_ACCOUNT_ID | 주어진 카카오계정 ID에 해당하는 개발자 계정이 존재하는지 조회합니다. |
| REGISTER Internal | 새로운 개발자 계정을 등록합니다. |
| REGISTER_BY_ACCOUNT_ID Internal | 카카오계정 ID로 새로운 개발자 계정을 등록합니다. |
이메일로 개발자 계정을 조회합니다.
조회할 개발자 계정의 이메일을 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 해당 개발자 계정 정보를 payload에 포함합니다. 존재하지 않는 개발자 계정 이메일로 요청한 경우 에러 응답을 받습니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
String | 개발자 계정의 이메일 | O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_BY_EMAIL","payload": {"email": "sample@sample.com"}}'
응답 예제
// HTTP/2 200{"account_status": "NORMAL","id": 576952,"name": "Sample","company": "SampleCompany","account_id": 2137162,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2020-02-17T06:43:02Z","updated_at": "2020-02-17T06:43:02Z"}
응답 예제, 개발자 계정 찾을 수 없음
// HTTP/2 404{"message": "NOT_FOUND"}
카카오계정 ID로 개발자 계정을 조회합니다.
조회할 개발자 계정의 카카오계정 ID를 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 해당 개발자 계정 정보를 payload에 포함합니다. 존재하지 않는 개발자 계정의 카카오계정 ID로 요청한 경우 카카오계정에 해당하는 개발자 계정을 찾을 수 없다는 에러 응답을 받습니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| account_id | Int | 개발자 계정의 카카오계정 ID | O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_BY_ACCOUNT_ID","payload": {"account_id": 2137162}}'
응답 예제
// HTTP/2 200{"account_status": "NORMAL","id": 576952,"name": "Sample","company": "SampleCompany","account_id": 2137162,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2020-02-17T06:43:02Z","updated_at": "2020-02-17T06:43:02Z"}
응답 예제, 카카오계정에 해당하는 개발자 계정 찾을 수 없음
// HTTP/2 404{"message": "Failed to find the Developer: [accountId: 2139999]"}
카카오계정 ID로 개발자 계정 상태를 조회합니다. 아직 초대 중이거나 제재된 상태를 포함해 개발자 계정의 상태를 확인할 수 있습니다.
상태를 조회할 개발자 계정의 카카오계정 ID를 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 해당 개발자 계정 정보를 payload에 포함합니다. 존재하지 않는 개발자 계정의 카카오계정 ID로 요청한 경우 카카오계정에 해당하는 개발자 계정을 찾을 수 없다는 에러 응답을 받습니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| account_id | Int | 개발자 계정의 카카오계정 ID | O |
응답 페이로드
REGISTERED,INVITED,SUSPENDED_DEREGISTER중 하나,DeveloperInfo참고
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_STATUS_BY_ACCOUNT_ID","payload": {"account_id": 2137162}}'
응답 예제
// HTTP/2 200"REGISTERED"
응답 예제, 카카오계정 ID에 해당하는 개발자 계정 찾을 수 없음
// HTTP/2 404{"message": "Failed to find the Developer: [accountId: 2139999]"}
주어진 이메일로 등록된 개발자 계정이 존재하는지 조회합니다.
개발자 계정 이메일을 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 이메일에 해당하는 개발자 계정 존재 여부를 payload에 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
String | 개발자 계정의 이메일 | O |
응답 페이로드
- 이메일에 해당하는 개발자 계정 존재 여부
true: 존재false: 미존재
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "IS_REGISTERED_BY_EMAIL","payload": {"email": "sample@sample.com"}}'
응답 예제
// HTTP/2 200true
주어진 카카오계정 ID에 해당하는 개발자 계정이 존재하는지 조회합니다.
개발자 계정의 카카오계정 ID를 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 카카오계정 ID에 해당하는 개발자 계정 존재 여부를 payload에 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| account_id | Int | 개발자 계정의 카카오계정 ID | O |
응답 페이로드
- 카카오계정 ID에 해당하는 개발자 계정 존재 여부
true: 존재false: 미존재
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "IS_REGISTERED_BY_ACCOUNT_ID","payload": {"account_id": 2137162}}'
응답 예제
// HTTP/2 200true
새로운 개발자 계정을 등록합니다. 이 액션은 API플랫폼 내부에서만 사용합니다. 서비스에서 개발자 계정 등록이 필요한 경우에는 개발자 계정 등록을 참고합니다.
개발자 계정 등록에 필요한 이름, 이메일 정보를 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 새롭게 등록된 개발자 계정 정보를 payload에 포함합니다. 요청 시 전달된 이름과 이메일로 이미 개발자 계정이 등록되어 있는 경우, 에러 응답은 payload에 해당 개발자 계정 정보를 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| name | Int | 개발자 계정의 이름 | O |
String | 개발자 계정의 이메일 | O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "REGISTER","payload": {"name": "Sample","email": "sample@sample.com"}}'
응답 예제
// HTTP/2 200{"id": 685775,"name": "Sample","company": "-","account_id": 2350171,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2022-10-11T03:27:22Z","updated_at": "2022-10-11T03:27:22Z"}
응답 예제, 이미 등록된 개발자 계정
// HTTP/2 400{"message": "developer is already registered. developer=DeveloperEntity{id=729169, kakaoAccountId=2350171, kakaoAccountEmail='-', status=REGISTERED, pricePlan=BASIC, name='따샤', company='-', createdAt=2022-10-11 06:21:41.0, updatedAt=2022-10-11 06:21:41.0}","exception": "com.kakao.capri.commons.service.DeveloperAlreadyExistsException"}
카카오계정 ID로 새로운 개발자 계정을 등록합니다. REGISTER를 함께 참고합니다.
개발자 계정으로 등록할 카카오계정 ID와 개발자 계정 이름을 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 새롭게 등록된 개발자 계정 정보를 payload에 포함합니다. 해당 카카오계정이 이미 개발자 계정으로 등록되어 있는 경우, 에러 응답은 해당 개발자 계정 정보를 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| name | Int | 개발자 계정의 이름 | O |
| account_id | Int | 개발자 계정의 카카오계정 ID | O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "REGISTER_BY_ACCOUNT_ID""payload": {"name": "Sample","account_id": 2350171}}'
응답 예제
// HTTP/2 200{"id": 729169,"name": "Sample","company": "-","account_id": 2350171,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2022-10-11T06:21:41Z","updated_at": "2022-10-11T06:21:41Z"}
응답 예제, 이미 등록된 개발자 계정
// HTTP/2 400{"message": "developer is already registered. developer=DeveloperEntity{id=729169, kakaoAccountId=2350171, kakaoAccountEmail='-', status=REGISTERED, pricePlan=BASIC, name='따샤', company='-', createdAt=2022-10-11 06:21:41.0, updatedAt=2022-10-11 06:21:41.0}","exception": "com.kakao.capri.commons.service.DeveloperAlreadyExistsException"}
:developer_id부분에 요청 대상 개발자 계정 ID를 입력해야 합니다.
| 메서드 | 호스트 | 리소스 |
|---|---|---|
POST | internal-admin-kapi.kakao.com | /developer/:developer_id |
| 이름 | 설명 |
|---|---|
| FIND | 개발자 계정 상세 정보를 조회합니다. |
| FIND_STATUS | 개발자 계정 상태를 조회합니다. |
| UPDATE | 개발자 계정 상세 정보를 변경합니다. |
| UPDATE_PROFILE | 개발자 계정 이름을 변경합니다. |
| UPDATE_STATUS | 개발자 계정 상태를 변경합니다. |
| DEREGISTER | 개발자 계정을 탈퇴 처리합니다. |
| IS_OWN_IDENTIFY Internal | 개발자 계정에 해당하는 카카오계정의 본인인증 여부를 확인합니다. |
| IS_REGISTERED | 현재 등록된 개발자 계정인지 조회합니다. |
| CREATE_APP | 개발자 계정을 소유자(OWNER)로 하는 새로운 앱을 등록합니다. |
| FIND_ALL_MEMBER | 개발자 계정이 멤버로 참여 중인 앱 목록을 조회합니다. |
| FIND_ALL_MEMBER_APP | 개발자 계정이 멤버로 참여 중인 앱의 상세 정보 목록을 조회합니다. |
| FIND_ALL_MEMBER_APP_AND_APP_KEY | 개발자 계정이 멤버로 참여 중인 앱과 앱 키 목록을 조회합니다. |
| FIND_ALL_MEMBER_APP_AND_BIZ_APP | 개발자 계정이 멤버로 참여 중인 앱의 비즈 앱 여부를 포함한 상세 정보 목록을 조회합니다. |
개발자 계정 상세 정보를 조회합니다.
요청 처리 성공 시 응답은 해당 개발자 계정 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND"}'
응답 예제
// HTTP/2 200{"id": 729169,"name": "Sample","company": "-","account_id": 2350171,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2022-10-11T06:21:41Z","updated_at": "2022-10-11T06:21:41Z"}
개발자 계정 상태를 조회합니다. 아직 초대 중이거나 제재된 상태를 포함해 개발자 계정의 상태를 확인할 수 있습니다.
요청 처리 성공 시 응답은 개발자 계정의 상태를 payload에 포함합니다. 개발자 계정 ID에 해당하는 개발자 계정이 없는 경우 에러 응답을 받습니다.
요청 페이로드
- 없음
응답 페이로드
REGISTERED,INVITED,SUSPENDED_DEREGISTER중 하나,DeveloperInfo참고
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_STATUS"}'
응답 예제
// HTTP/2 200"REGISTERED"
응답 예제, 개발자 계정에 해당하는 개발자 계정 없음
// HTTP/2 404{"message": "Failed to find the Developer: 729199";}
개발자 계정 상세 정보를 변경합니다. 변경 가능한 정보는 이름(name), 상태(status) 두 종류입니다. 요금제(price_plan)는 현재 사용하지 않는 정보입니다.
변경할 정보의 키와 값을 payload에 포함해 요청합니다. 요금제(price_plan)는 현재 사용하지 않는 정보라도 필수 파라미터이므로 기존 값을 전달합니다.
요청 처리 성공 시 응답은 변경된 개발자 계정 정보를 payload에 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| name | Int | 개발자 계정의 이름 | O |
| status | String | 개발자 계정의 상태, 아래 중 하나
| O |
| price_plan | String | 요금제, 미사용UPDATE 액션 요청 시, 기존 price_plan 값을 그대로 전달 | O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "UPDATE","payload": {"name": "Sample","status": "REGISTERED","price_plan": "BASIC"}}'
응답 예제
// HTTP/2 200{"id": 729170,"name": "Sample","company": "-","account_id": 2350171,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2022-10-11T07:05:30Z","updated_at": "2022-10-11T11:02:32Z"}
개발자 계정 이름을 변경합니다.
개발자 계정의 변경할 이름(name)을 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 이름이 변경된 개발자 계정 정보를 payload에 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| name | Int | 개발자 계정의 이름 | O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "UPDATE_PROFILE","payload": {"name": "Sample"}}'
응답 예제
// HTTP/2 200{"id": 729170,"name": "Sample","company": "-","account_id": 2350171,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2022-10-11T07:05:30Z","updated_at": "2022-10-11T11:07:37Z"}
개발자 계정 상태를 변경합니다.
변경할 개발자 계정 상태를 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 상태 변경 후 개발자 계정 정보를 payload에 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| status | String | 개발자 계정의 상태, 아래 중 하나
| O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "UPDATE_STATUS"}'
응답 예제
// HTTP/2 200{"id": 729170,"name": "Sample","company": "-","account_id": 2350171,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2022-10-11T07:05:30Z","updated_at": "2022-10-11T11:09:34Z"}
개발자 계정을 탈퇴 처리합니다. 개발자 계정 탈퇴는 카카오디벨로퍼스에서의 개발자 계정 등록을 철회하는 것으로, 카카오계정의 탈퇴와 무관합니다.
요청 처리 성공 시 응답은 탈퇴 처리된 개발자 계정의 기존 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND"}'
응답 예제
// HTTP/2 200{"id": 729170,"name": "Sample","company": "-","account_id": 2350171,"email": "-","status": "REGISTERED","price_plan": "BASIC","created_at": "2022-10-11T07:05:30Z","updated_at": "2022-10-11T11:10:18Z"}
개발자 계정에 해당하는 카카오계정의 본인인증 여부를 확인합니다.
요청 페이로드
- 없음
응답 페이로드
- 카카오계정 ID에 해당하는 카카오계정의 본인인증 여부
true: 본인인증 정보 있음false: 본인인증 정보 없음
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "IS_OWN_IDENTIFY"}'
응답 예제
// HTTP/2 200true
현재 등록된 개발자 계정인지 조회합니다.
요청 처리 성공 시 응답은 개발자 계정 존재 여부를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
- 이메일에 해당하는 개발자 계정 존재 여부
true: 존재false: 미존재
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "IS_REGISTERED"}'
응답 예제
// HTTP/2 200true
개발자 계정을 소유자(OWNER)로 하는 새로운 앱을 등록합니다.
앱의 이름, 회사명, 아이콘 파일 또는 KAGE 토큰을 payload에 포함해 요청합니다.
요청 처리 성공 시 응답은 등록된 앱 기본 정보를 payload에 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| name | String | 앱 이름(영문 기준 최대 45자) | O |
| company | String | 회사명(영문 기준 최대 50자) | O |
| category | AppCategory | 앱 카테고리 | X |
| icon_image_kage_token | String | File | 앱 아이콘 이미지의 KAGE 토큰 또는 이미지 파일 | X |
응답 페이로드
요청 예제: 앱 아이콘 파일 업로드
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-F "name=CREATE_APP" \-F "payload.name=${APP_NAME}" \-F "payload.company=${COMPANY_NAME}" \-F "payload.category=${APP_CATEGORY}" \-F "payload.icon_image_kage_token=@${FILE_PATH}"
요청 예제: 앱 아이콘 KAGE 토큰 사용
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "CREATE_APP","payload": {"name": "${APP_NAME}","company": "${COMPANY_NAME}","category": "${APP_CATEGORY}","icon_image_kage_token": "${KAGE_TOKEN}"}}'
응답 예제
// HTTP/2 200{"id": 1240129,"name": "Sample","company": "SampleCompany","icon": "https://k.kakaocdn.net/14/dn/ZSiVGrbg5M/qefisjASdJ7R2Kilh2K3CK/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"}
개발자 계정이 멤버로 참여 중인 앱 목록을 조회합니다.
요청 처리 성공 시 응답은 각 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
Member의 배열
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_ALL_MEMBER"}'
응답 예제
// HTTP/2 200[{"app_id": 1240129,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:26:21Z","updated_at": "2022-10-11T11:26:21Z"},{"app_id": 1240130,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:27:19Z","updated_at": "2022-10-11T11:27:19Z"}]
개발자 계정이 팀원으로 참여 중인 앱의 기본 정보와 개발자 계정 팀원 정보 목록을 조회합니다.
요청 처리 성공 시 응답은 각 앱의 기본 정보와 해당 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
MemberSimpleApp의 배열
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_ALL_MEMBER_APP"}'
응답 예제
// HTTP/2 200[{"app": {"id": 1240129,"name": "Sample","company": "SampleCompany","icon": "https://k.kakaocdn.net/14/dn/ZSiVGrbg5M/qefisjASdJ7R2Kilh2K3CK/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240129,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:26:21Z","updated_at": "2022-10-11T11:26:21Z"},{"app": {"id": 1240130,"name": "Sample2","company": "SampleCompany","icon": "https://k.kakaocdn.net/14/dn/ZSiVGkpVUw/X6TR8YKSRM0kO65luJ83c0/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240130,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:27:19Z","updated_at": "2022-10-11T11:27:19Z"}]
개발자 계정이 팀원으로 참여 중인 앱과 앱 키 목록, 개발자 계정 팀원 정보를 조회합니다.
요청 처리 성공 시 응답은 앱 기본 정보, 앱 키, 해당 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
MemberApp의 배열
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_ALL_MEMBER_APP_AND_APP_KEY"}'
응답 예제
// HTTP/2 200[{"app": {"app_key": {"NATIVE_APP_KEY": "${NATIVE_APP_KEY}","REST_API_KEY": "${REST_API_KEY}","JAVASCRIPT_KEY": "${JAVASCRIPT_KEY}","ADMIN_KEY": "${ADMIN_KEY}"},"id": 1240129,"name": "Sample","company": "SampleCompany","icon": "https://k.kakaocdn.net/14/dn/ZSiVGrbg5M/qefisjASdJ7R2Kilh2K3CK/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240129,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:26:21Z","updated_at": "2022-10-11T11:26:21Z"},{"app": {"app_key": {"NATIVE_APP_KEY": "${NATIVE_APP_KEY}","REST_API_KEY": "${REST_API_KEY}","JAVASCRIPT_KEY": "${JAVASCRIPT_KEY}","ADMIN_KEY": "${ADMIN_KEY}"},"id": 1240130,"name": "Sample2","company": "SampleCompany","icon": "https://k.kakaocdn.net/14/dn/ZSiVGkpVUw/X6TR8YKSRM0kO65luJ83c0/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240130,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:27:19Z","updated_at": "2022-10-11T11:27:19Z"}]
개발자 계정이 팀원으로 참여 중인 앱의 비즈 앱 정보를 포함한 상세 정보와 개발자 계정 팀원 정보 목록을 조회합니다.
요청 처리 성공 시 응답은 각 앱의 기본 정보와 비즈니스 정보, 해당 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다. 비즈니스 정보는 비즈 앱인 경우에만 응답에 포함됩니다.
요청 페이로드
- 없음
응답 페이로드
MemberBizApp의 배열
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_ALL_MEMBER_APP_AND_BIZ_APP"}'
응답 예제
// HTTP/2 200[{"app": {"biz_app": {"app_id": 1240129,"biz_num": "000-00-99999","biz_plus_friends": "FALSE","created_at": "2022-10-11T12:02:41Z","updated_at": "2022-10-11T12:02:41Z"},"id": 1240129,"name": "SampleBizApp","company": "SampleCompany","icon": "https://k.kakaocdn.net/14/dn/ZSiVGrbg5M/qefisjASdJ7R2Kilh2K3CK/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240129,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:26:21Z","updated_at": "2022-10-11T11:26:21Z"},{"app": {"id": 1240130,"name": "Sample","company": "SampleCompany","icon": "https://k.kakaocdn.net/14/dn/ZSiVGkpVUw/X6TR8YKSRM0kO65luJ83c0/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240130,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:27:19Z","updated_at": "2022-10-11T11:27:19Z"}]
:developer_id부분에 요청 대상 개발자 계정 ID를 입력해야 합니다.
| 메서드 | 호스트 | 리소스 |
|---|---|---|
POST | internal-admin-kapi.kakao.com | /developer/:developer_id/bizApp |
| 이름 | 설명 |
|---|---|
| FIND_ALL | 개발자 계정이 팀원으로 참여 중인 모든 앱 중 비즈 앱 목록을 조회합니다. |
| FIND_ALL_MEMBER | 개발자 계정이 팀원으로 참여 중인 각 비즈 앱에서의 팀원 정보를 조회합니다. |
개발자 계정이 팀원으로 참여 중인 앱 중 비즈 앱 목록을 조회합니다.
요청 처리 성공 시 응답은 비즈 앱 정보, 해당 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
MemberBizApp의 배열
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/bizApp" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_ALL"}'
응답 예제
// HTTP/2 200[{"app": {"biz_app": {"app_id": 1240129,"biz_num": "000-00-99999","biz_plus_friends": "FALSE","created_at": "2022-10-11T12:02:41Z","updated_at": "2022-10-11T12:02:41Z"},"id": 1240129,"name": "SampleBizApp","company": "SampleCompany","icon": "https://alpha-k.kakaocdn.net/14/dn/ZSiVGrbg5M/qefisjASdJ7R2Kilh2K3CK/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240129,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:26:21Z","updated_at": "2022-10-11T11:26:21Z"}]
개발자 계정이 팀원으로 참여 중인 각 비즈 앱에서의 팀원 정보를 조회합니다.
요청 처리 성공 시 응답은 각 비즈 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
Member의 배열
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/bizApp" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND_ALL_MEMBER"}'
응답 예제
[{"app_id": 1240129,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:26:21Z","updated_at": "2022-10-11T11:26:21Z"}]
:developer_id부분에 요청 대상 개발자 계정 ID를 입력해야 합니다.:app_id부분에 요청 대상 앱 ID를 입력해야 합니다.
| 메서드 | 호스트 | 리소스 |
|---|---|---|
POST | internal-admin-kapi.kakao.com | /developer/:developer_id/bizApp/:app_id |
| 이름 | 설명 |
|---|---|
| FIND | 개발자 계정이 팀원으로 참여 중인 특정 비즈 앱 정보를 조회합니다. |
개발자 계정이 팀원으로 참여 중인 특정 비즈 앱 정보를 조회합니다.
요청 처리 성공 시 응답은 비즈 앱 정보, 해당 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/bizApp/:app_id" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND"}'
응답 예제
// HTTP/2 200{"app": {"biz_app": {"app_id": 1240129,"biz_num": "000-00-99999","biz_plus_friends": "FALSE","created_at": "2022-10-11T12:02:41Z","updated_at": "2022-10-11T12:02:41Z"},"id": 1240129,"name": "SampleBizApp","company": "SampleCompany","icon": "https://alpha-k.kakaocdn.net/14/dn/ZSiVGrbg5M/qefisjASdJ7R2Kilh2K3CK/o.jpg","app_type": "DEFAULT","category": "Book_Reference","status": "ACTIVE","phase": "NORMAL"},"app_id": 1240129,"developer_id": 729172,"role": "OWNER","created_at": "2022-10-11T11:26:21Z","updated_at": "2022-10-11T11:26:21Z"}
:developer_id부분에 대상 개발자 계정 ID를 입력해야 합니다.
| 메서드 | 호스트 | 리소스 |
|---|---|---|
POST | internal-admin-kapi.kakao.com | /developer/:developer_id/dspAccount |
| 이름 | 설명 |
|---|---|
| FIND | 개발자 계정의 통합 계정 정보를 조회합니다. |
| IS_REGISTERED | 개발자 계정에 통합 계정 정보가 등록돼 있는지 조회합니다. |
| CREATE Internal | 개발자 계정에 통합 계정 정보를 등록합니다. |
| DELETE Internal | 개발자 계정의 통합 계정 정보를 삭제합니다. |
개발자 계정의 통합 계정 정보를 조회합니다. 이 액션은 통합 계정 회원 정보를 조회하지 않고, 카카오 API 플랫폼의 개발자 계정에 등록된 통합 계정 정보만 조회합니다.
요청 처리 성공 시 응답은 개발자 계정의 통합 계정 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/dspAccount" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "FIND"}'
응답 예제
// HTTP/2 200{"developer_id": 576952,"dsp_account_id": 12345678,"created_at": "2023-03-14T07:01:34Z"}
개발자 계정에 통합 계정 정보가 등록돼 있는지 조회합니다.
요청 처리 성공 시 응답은 개발자 계정의 통합 계정 정보 등록 여부를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
- 개발자 계정의 통합 계정 정보 등록 여부
true: 등록false: 미등록
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/dspAccount" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "IS_REGISTERED"}'
응답 예제
// HTTP/2 200false
개발자 계정에 통합 계정 정보를 등록합니다. 이 액션은 통합 계정 ID의 유효성을 검증하지 않고, 개발자 계정에 통합 계정 ID를 등록하는 동작만 수행합니다.
payload 하위의 파라미터로 등록할 통합 계정 ID를 전달합니다.
요청 처리 성공 시 응답은 등록된 개발자 계정의 통합 계정 정보를 payload에 포함합니다.
요청 페이로드
| 이름 | 타입 | 설명 | 필수 |
|---|---|---|---|
| dsp_account_id | Long | 통합 계정 ID | O |
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/dspAccount" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "CREATE","payload": {"dsp_account_id": "12345678"}}'
응답 예제
// HTTP/2 200{"developer_id": 576952,"dsp_account_id": 12345678,"created_at": "2023-03-14T08:05:32Z"}
개발자 계정의 통합 계정 정보를 삭제합니다. 이 액션은 통합 계정을 삭제하지 않고, 개발자 계정에 등록된 통합 계정 ID를 삭제하는 동작만 수행합니다.
요청 처리 성공 시 응답은 삭제된 개발자 계정의 통합 계정 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/dspAccount" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "DELETE"}'
응답 예제
// HTTP/2 200{"developer_id": 576952,"dsp_account_id": 12345678,"created_at": "2023-03-14T08:05:57Z"}
:developer_id부분에 대상 개발자 계정 ID를 입력해야 합니다.
| 메서드 | 호스트 | 리소스 |
|---|---|---|
POST | internal-admin-kapi.kakao.com | /developer/:developer_id/block |
| 이름 | 설명 |
|---|---|
| IS_BLOCKED Internal | 개발자 계정이 차단 상태인지 조회합니다. |
| BLOCK Internal | 개발자 계정을 차단합니다. |
| UNBLOCK Internal | 개발자 계정을 차단 해제합니다. |
개발자 계정이 차단 상태인지 조회합니다. 이 액션은 개발자 계정을 차단하는 ALFS 규칙의 적용 대상 목록에 해당 개발자 계정이 포함돼 있는지 확인합니다.
요청 처리 성공 시 응답은 개발자 계정의 차단 여부를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
- 개발자 계정의 차단 여부
true: 차단false: 차단되어 있지 않음
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/block" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "IS_BLOCKED"}'
응답 예제
// HTTP/2 200false
개발자 계정을 차단합니다. 이 액션은 개발자 계정을 차단하는 ALFS 규칙의 적용 대상 목록에 해당 개발자 계정을 대상으로 추가합니다.
요청 처리 성공 시 응답은 ALFS 규칙에 등록된 개발자 계정 차단 정보를 payload에 포함합니다.
요청 페이로드
- 없음
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/block" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "BLOCK"}'
응답 예제
// HTTP/2 200{"id": 2785,"factor_id": 845,"rule_id": 42,"name": "ownerDeveloperId","value": "732025","value_type": "INTEGER","created_at": "2023-03-14T08:17:21Z","updated_at": "2023-03-14T08:17:21Z"}
개발자 계정을 차단 해제합니다. 이 액션은 개발자 계정을 차단하는 ALFS 규칙의 적용 대상 목록에서 해당 개발자 계정을 삭제합니다.
요청 처리 성공 시 응답은 ALFS 규칙에서 삭제된 개발자 계정 차단 정보를 payload에 포함합니다. 개발자 계정이 복수의 ALFS 규칙으로 차단되어 있는 경우가 있으므로 배열 형식의 응답을 받습니다.
요청 페이로드
- 없음
응답 페이로드
요청 예제
curl -v POST "https://internal-admin-kapi.kakao.com/developer/:developer_id/block" \-H "Content-Type: application/json; charset=utf-8" \-H "ADMIN-API-META-RENDER: simple" \-u "${GROUP_NAME}:${GROUP_TOKEN}" \-H "ADMIN-API-USERID: ${USER_INFO}" \-d $'{"name": "REMOVE"}'
응답 예제
// HTTP/2 200{"id": 2785,"factor_id": 845,"rule_id": 42,"name": "ownerDeveloperId","value": "732025","value_type": "INTEGER","created_at": "2023-03-14T08:17:21Z","updated_at": "2023-03-14T08:17:21Z"}