본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트

사이드 메뉴

플랫폼 API

API 제공

전용 API

어드민 API

신규 어드민 API 제공

이 문서는 제공 종료된 구버전 어드민 API에 대해 안내합니다. 신규 어드민 API에 대한 자세한 내용은 신규 어드민 API 제공 안내에서 확인할 수 있습니다.

이 문서는 카카오디벨로퍼스 개발자 계정에 대한 어드민 API 사용 방법을 안내합니다.

각 제목에 부착된 태그(Tag)는 아래와 같은 의미입니다.

태그설명
Internal
이 액션은 API플랫폼 내부에서만 사용합니다.
메서드호스트리소스
POSTinternal-admin-kapi.kakao.com/developer
* 모든 어드민 API는 사내망에서만 호출 가능, 인증 필요
이름설명
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에 포함합니다. 존재하지 않는 개발자 계정 이메일로 요청한 경우 에러 응답을 받습니다.

이름타입설명필수
emailString개발자 계정의 이메일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_idInt개발자 계정의 카카오계정 IDO
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_idInt개발자 계정의 카카오계정 IDO
  • 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"
// HTTP/2 404
{
"message": "Failed to find the Developer: [accountId: 2139999]"
}

주어진 이메일로 등록된 개발자 계정이 존재하는지 조회합니다.

개발자 계정 이메일을 payload에 포함해 요청합니다.

요청 처리 성공 시 응답은 이메일에 해당하는 개발자 계정 존재 여부를 payload에 포함합니다.

이름타입설명필수
emailString개발자 계정의 이메일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 200
true

주어진 카카오계정 ID에 해당하는 개발자 계정이 존재하는지 조회합니다.

개발자 계정의 카카오계정 ID를 payload에 포함해 요청합니다.

요청 처리 성공 시 응답은 카카오계정 ID에 해당하는 개발자 계정 존재 여부를 payload에 포함합니다.

이름타입설명필수
account_idInt개발자 계정의 카카오계정 IDO
  • 카카오계정 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 200
true

새로운 개발자 계정을 등록합니다. 이 액션은 API플랫폼 내부에서만 사용합니다. 서비스에서 개발자 계정 등록이 필요한 경우에는 개발자 계정 등록을 참고합니다.

개발자 계정 등록에 필요한 이름, 이메일 정보를 payload에 포함해 요청합니다.

요청 처리 성공 시 응답은 새롭게 등록된 개발자 계정 정보를 payload에 포함합니다. 요청 시 전달된 이름과 이메일로 이미 개발자 계정이 등록되어 있는 경우, 에러 응답은 payload에 해당 개발자 계정 정보를 포함합니다.

이름타입설명필수
nameInt개발자 계정의 이름O
emailString개발자 계정의 이메일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에 포함합니다. 해당 카카오계정이 이미 개발자 계정으로 등록되어 있는 경우, 에러 응답은 해당 개발자 계정 정보를 포함합니다.

이름타입설명필수
nameInt개발자 계정의 이름O
account_idInt개발자 계정의 카카오계정 IDO
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를 입력해야 합니다.
메서드호스트리소스
POSTinternal-admin-kapi.kakao.com/developer/:developer_id
* 모든 어드민 API는 사내망에서만 호출 가능, 인증 필요
이름설명
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에 포함합니다.

이름타입설명필수
nameInt개발자 계정의 이름O
statusString개발자 계정의 상태, 아래 중 하나
  • REGISTERED: 개발자 계정으로 등록 완료된 상태
  • INVITED: 팀원으로 초대 받았으나 아직 개발자 계정으로 등록하지 않은 상태
  • SUSPENDED_DEREGISTER: 계정 보호 조치 등으로 인한 개발자 계정 탈퇴 상태
O
price_planString요금제, 미사용
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에 포함합니다.

이름타입설명필수
nameInt개발자 계정의 이름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에 포함합니다.

이름타입설명필수
statusString개발자 계정의 상태, 아래 중 하나
  • REGISTERED: 개발자 계정으로 등록 완료된 상태
  • INVITED: 팀원으로 초대 받았으나 아직 개발자 계정으로 등록하지 않은 상태
  • SUSPENDED_DEREGISTER: 계정 보호 조치 등으로 인한 개발자 계정 탈퇴 상태
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 200
true

현재 등록된 개발자 계정인지 조회합니다.

요청 처리 성공 시 응답은 개발자 계정 존재 여부를 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 200
true

개발자 계정을 소유자(OWNER)로 하는 새로운 앱을 등록합니다.

앱의 이름, 회사명, 아이콘 파일 또는 KAGE 토큰을 payload에 포함해 요청합니다.

요청 처리 성공 시 응답은 등록된 앱 기본 정보를 payload에 포함합니다.

이름타입설명필수
nameString앱 이름(영문 기준 최대 45자)O
companyString회사명(영문 기준 최대 50자)O
categoryAppCategory앱 카테고리X
icon_image_kage_tokenString | 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}"
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에 포함합니다.

  • 없음
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에 포함합니다.

  • 없음
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에 포함합니다.

  • 없음
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에 포함합니다. 비즈니스 정보는 비즈 앱인 경우에만 응답에 포함됩니다.

  • 없음
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를 입력해야 합니다.
메서드호스트리소스
POSTinternal-admin-kapi.kakao.com/developer/:developer_id/bizApp
* 모든 어드민 API는 사내망에서만 호출 가능, 인증 필요
이름설명
FIND_ALL개발자 계정이 팀원으로 참여 중인 모든 앱 중 비즈 앱 목록을 조회합니다.
FIND_ALL_MEMBER개발자 계정이 팀원으로 참여 중인 각 비즈 앱에서의 팀원 정보를 조회합니다.

개발자 계정이 팀원으로 참여 중인 앱 중 비즈 앱 목록을 조회합니다.

요청 처리 성공 시 응답은 비즈 앱 정보, 해당 앱에서의 개발자 계정 팀원 정보를 payload에 포함합니다.

  • 없음
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에 포함합니다.

  • 없음
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를 입력해야 합니다.
메서드호스트리소스
POSTinternal-admin-kapi.kakao.com/developer/:developer_id/bizApp/:app_id
* 모든 어드민 API는 사내망에서만 호출 가능, 인증 필요
이름설명
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를 입력해야 합니다.
메서드호스트리소스
POSTinternal-admin-kapi.kakao.com/developer/:developer_id/dspAccount
* 모든 어드민 API는 사내망에서만 호출 가능, 인증 필요
이름설명
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 200
false

개발자 계정에 통합 계정 정보를 등록합니다. 이 액션은 통합 계정 ID의 유효성을 검증하지 않고, 개발자 계정에 통합 계정 ID를 등록하는 동작만 수행합니다.

payload 하위의 파라미터로 등록할 통합 계정 ID를 전달합니다.

요청 처리 성공 시 응답은 등록된 개발자 계정의 통합 계정 정보를 payload에 포함합니다.

이름타입설명필수
dsp_account_idLong통합 계정 IDO
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를 입력해야 합니다.
메서드호스트리소스
POSTinternal-admin-kapi.kakao.com/developer/:developer_id/block
* 모든 어드민 API는 사내망에서만 호출 가능, 인증 필요
이름설명
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 200
false

개발자 계정을 차단합니다. 이 액션은 개발자 계정을 차단하는 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"
}

도움이 되었나요?