https://kauth.kakao.com/oauth/authorize?response_type=code&client_id=${REST_API_KEY}&redirect_uri=${REDIRECT_URI}

HTTP/1.1 302
Content-Length: 0
Location: ${REDIRECT_URI}?code=${AUTHORIZE_CODE}

HTTP/1.1 302
Content-Length: 0
Location: ${REDIRECT_URI}?error=access_denied&error_description=User%20denied%20access

curl -v -X POST "http://kapi.kakao.com/v1/internal/user/signup" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

curl -v -X POST "https://kapi.kakao.com/v1/user/signup" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  --data-urlencode 'properties={"age":"23", "gender":"female"}'

curl -v -X POST "http://kapi.kakao.com/v1/internal/user/signup" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  -d "target_id=1376016924429759243" \
  -d "target_id_type=user_id" \
  --data-urlencode 'properties={"age":"23", "gender":"female"}'

// HTTP/1.1 200 OK
{
  "id": 1376016924429759228
}

// HTTP/1.1 400 Bad Request
{
  "msg": "already registered",
  "code": -102
}

// HTTP/1.1 401 Unauthorized
{
  "msg": "this access token does not exist",
  "code": -401
}

// HTTP/1.1 400 Bad Request
{
  "msg": "user property not found ([gender, age] for appId=${APP_ID})",
  "code": -201
}

curl -v -X POST "http://kapi.kakao.com/v1/internal/user/unlink" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

curl -v -X POST "http://kapi.kakao.com/v1/internal/user/unlink" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  -d "target_id_type=account_id&target_id=200937"

curl -v -X POST "http://kapi.kakao.com/v1/internal/user/unlink" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_app_key=${SERVICE_APP_KEY}&target_id_type=account_id&target_id=200937"

curl -v -X POST "http://kapi.kakao.com/v1/internal/user/unlink" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_app_id=57669&target_id_type=account_id&target_id=200937"

curl -v -X POST "http://kapi.kakao.com/v1/internal/user/unlink" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_access_token=${ACCESS_TOKEN}"

{
  "id": 1376016924426814086
}

curl -v -G GET "http://kapi.kakao.com/v1/internal/user/access_token_info" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

curl -v -G GET "http://kapi.kakao.com/v1/internal/user/access_token_info" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_access_token=${ACCESS_TOKEN}"

{
  "id": 1227075864,
  "expires_in": 21420,
  "app_id": 80859,
  "account_id": 7075535 // 내부 API 요청 시에만 제공, 권한 필요
}

// HTTP/1.1 401 Unauthorized
{
  "code": -401,
  "msg": "this access token does not exist"
}

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/scopes" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/scopes" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -d 'scopes=["account_email","friends"]'

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/scopes" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  -d "target_id=1376016924427232667" \
  -d "target_id_type=user_id"

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/scopes" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_app_key=${SERVICE_APP_KEY}" \
  -d "target_id=1376016924427232667" \
  -d "target_id_type=user_id"

{
  "id": 1376016924429759243,
  "scopes": [
    {
      "id": "profile",
      "display_name": "Profile Info(nickname/profile image)",
      "type": "PRIVACY",
      "using": true, // 동의항목 사용 여부
      "agreed": true, // 사용자 동의 여부
      "revocable": false // 동의 철회 가능 여부
    },
    {
      "id": "account_email",
      "display_name": "Email",
      "type": "PRIVACY",
      "using": true, // 동의항목 사용 여부
      "agreed": true, // 사용자 동의 여부
      "revocable": true // 동의 철회 가능 여부
    },
    {
      "id": "shipping_address",
      "display_name": "Shipping information (receiver, shipping address, phone number)",
      "type": "PRIVACY",
      "using": true, // 동의항목 사용 여부
      "agreed": false // 사용자 동의 여부
    }
    // ...
  ]
}

{
  "id": 1376016924429759243,
  "scopes": [
    {
      "id": "friends",
      "display_name": "Friends List in Kakao Service(Including profile image, nickname, and favorites)",
      "type": "PRIVACY",
      "using": true,
      "agreed": true,
      "revocable": false
    },
    {
      "id": "account_email",
      "display_name": "Email",
      "type": "PRIVACY",
      "using": true,
      "agreed": false
    }
  ]
}

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/revoke/scopes" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  --data-urlencode 'scopes=["account_email"]'

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/revoke/scopes" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  --data-urlencode "target_id=1376016924427232667" \
  --data-urlencode "target_id_type=user_id" \
  --data-urlencode 'scopes=["account_birthdate","account_gender","friends"]'

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/revoke/scopes" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  --data-urlencode "target_app_key=${SERVICE_APP_KEY}" \
  --data-urlencode "target_id=1376016924427232667" \
  --data-urlencode "target_id_type=user_id" \
  --data-urlencode 'scopes=["account_birthdate","account_gender","friends"]'

{
  "id": 1376016924429759243,
  "scopes": [
    {
      "id": "profile",
      "display_name": "Profile Info(nickname/profile image)",
      "type": "PRIVACY",
      "using": true,
      "agreed": true,
      "revocable": false
    },
    {
      "id": "friends",
      "display_name": "Friends List in Kakao Service(Including profile image, nickname, and favorites)",
      "type": "PRIVACY",
      "using": true,
      "agreed": true,
      "revocable": false
    },
    {
      "id": "account_email",
      "display_name": "Email",
      "type": "PRIVACY",
      "using": true,
      "agreed": false //동의 철회에 성공해 동의 여부 값 false로 변경됨
    },
    {
      "id": "talk_chats",
      "display_name": "Read chat lists in Kakao Talk",
      "type": "SERVICE",
      "using": true,
      "agreed": true,
      "revocable": false
    }
    // ...
  ]
}

// HTTP/1.1 403 Forbidden
{
  "msg": "[profile] is not revocable. check out if it's set as required on developers.kakao.com",
  "code": -3
}

// HTTP/1.1 400 Bad Request
{
  "msg": "There is no scopes to revoke. check out if given scope id([email]) is correct again.",
  "code": -2
}

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/service_terms" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/service_terms" \
  -H 'Authorization: Bearer ${ACCESS_TOKEN}' \
  -d "result=app_service_terms"

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/service_terms" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  -d "target_id_type=user_id" \
  -d "target_id=${USER_ID}" \
  -d "tags=optional_no_consent,service_2020_0218"

curl -v -G GET "http://kapi.kakao.com/v2/internal/user/service_terms" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_app_key=${SERVICE_APP_KEY}" \
  -d "target_id_type=user_id" \
  -d "target_id=${USER_ID}" \

{
  "id": 111111,
  "service_terms": [
    {
      "tag": "optional_1",
      "required": false,
      "agreed": true,
      "revocable": true,
      "agreed_at": "2023-06-29T07:39:56Z",
      "agreed_by": "KAUTH"
    },
    {
      "tag": "optional_2",
      "required": false,
      "agreed": true,
      "revocable": true,
      "agreed_at": "2024-07-12T07:39:56Z",
      "agreed_by": "KAPI"
    }
    // ...
  ]
}

{
  "id": 111111,
  "service_terms": [
    {
      "tag": "optional_20200616",
      "required": false,
      "agreed": true,
      "revocable": true,
      "agreed_at": "2023-06-29T07:39:56Z",
      "agreed_by": "KAPI"
    },
    {
      "tag": "optional_no_consent",
      "required": false,
      "agreed": false,
      "revocable": true
    },
    {
      "tag": "service_2020_0218",
      "required": true,
      "agreed": true,
      "revocable": false,
      "agreed_at": "2023-06-29T07:39:56Z",
      "agreed_by": "KAUTH"
    }
    // ...
  ]
}

{
  "id": 111111,
  "service_terms": [
    {
      "tag": "optional_no_consent",
      "required": false,
      "agreed": false,
      "revocable": true
    },
    {
      "tag": "service_2020_0218",
      "required": true,
      "agreed": true,
      "revocable": false,
      "agreed_at": "2023-06-29T07:39:56Z",
      "agreed_by": "KAUTH"
    }
  ]
}

// HTTP/1.1 400 Bad Request
{
  "msg": "There is no tags to get service terms. check out to configured this tags([test_tag]) in app(test_app).",
  "code": -2
}

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/revoke/service_terms" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"
-d "tags=optional_20200616,optional_no_consent"

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/revoke/service_terms" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  -d "target_id_type=user_id" \
  -d "target_id=${USER_ID}" \
  -d "tags=optional_20200616,optional_no_consent"

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/revoke/service_terms" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_app_key=${SERVICE_APP_KEY}" \
  -d "target_id_type=user_id" \
  -d "target_id=${USER_ID}" \
  -d "tags=optional_20200616,optional_no_consent"

{
  "id": 111111,
  "revoked_service_terms": [
    {
      "tag": "optional_20200616",
      "agreed": false
    },
    {
      "tag": "optional_no_consent",
      "agreed": false
    }
  ]
}

// HTTP/1.1 400 Bad Request
{
  "msg": "There is no tags to revoke. check out to configured this tags([test_tag]) in app(test_app).",
  "code": -2
}

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/upgrade/service_terms" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -d "tags=term01,term02,term03"

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/upgrade/service_terms" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  -d "target_id=${USER_ID}" \
  -d "target_id_type=user_id" \
  -d "tags=term01,term02,term03"

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/upgrade/service_terms" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  -d "target_app_key=${SERVICE_APP_KEY}" \
  -d "target_id=${ACCOUNT_ID}" \
  -d "target_id_type=account_id" \
  -d "tags=term01,term02,term03"

// HTTP/1.1 200 OK
{
  "id": 1376016924429759243,
  "agreed_service_terms": [
    {
      "tag": "term03",
      "agreed": true,
      "agreed_at": "2023-08-02T08:33:25Z",
      "agreed_by": "KAPI"
    },
    {
      "tag": "term01",
      "agreed": true,
      "agreed_at": "2023-08-02T08:33:25Z",
      "agreed_by": "KAUTH"
    },
    {
      "tag": "term02",
      "agreed": true,
      "agreed_at": "2023-08-02T08:33:25Z",
      "agreed_by": "KAUTH"
    }
  ]
}

// HTTP/1.1 200 OK
{
  "id": 1376016924429759243,
  "agreed_service_terms": [
    {
      "tag": "term02",
      "agreed": true,
      "agreed_at": "2023-08-02T08:34:56Z"
    }
  ]
}

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/upgrade/scopes" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  --data-urlencode 'scopes=["birthday","gender","friends"]'

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/upgrade/scopes" \
  -H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
  --data-urlencode "target_id=1376016924427232667" \
  --data-urlencode "target_id_type=user_id" \
  --data-urlencode 'scopes=["birthday","gender","friends"]'

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/upgrade/scopes" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  --data-urlencode "target_app_key=${SERVICE_APP_KEY}" \
  --data-urlencode "target_id=1376016924427232667" \
  --data-urlencode "target_id_type=user_id" \
  --data-urlencode 'scopes=["birthday","gender","friends"]'

curl -v -X POST "http://kapi.kakao.com/v2/internal/user/upgrade/scopes" \
  -H "Authorization: KakaoAK ${DELEGATOR_APP_ADMIN_KEY}" \
  --data-urlencode "target_app_key=${SERVICE_APP_KEY}" \
  --data-urlencode "target_id=1376016924427232667" \
  --data-urlencode "target_id_type=user_id" \
  --data-urlencode 'scopes=["birthday","gender","friends","shipping_address"]' \
  -d 'channel=bizplugin'

{
  "id": 1376016924429759243,
  "scopes": [
    {
      "id": "profile",
      "display_name": "Profile Info(nickname/profile image)",
      "type": "PRIVACY",
      "using": true,
      "agreed": true,
      "revocable": false
    },
    {
      "id": "friends",
      "display_name": "Friends List in Kakao Service(Including profile image, nickname, and favorites)",
      "type": "PRIVACY",
      "using": true,
      "agreed": true,
      "revocable": false
    },
    {
      "id": "account_email",
      "display_name": "Email",
      "type": "PRIVACY",
      "using": true,
      "agreed": true, // 동의항목 추가 요청에 성공해 동의한 상태로 변경됨
      "revocable": true
    },
    {
      "id": "gender",
      "display_name": "Gender",
      "type": "PRIVACY",
      "using": true,
      "agreed": true,
      "revocable": true
    }
    // ...
  ]
}

// HTTP/1.1 403 Forbidden
{
  "msg": "[APP_NAME] App disabled [[shipping_address]] scopes on developers.kakao.com. Enable it first.",
  "code": -3
}

// HTTP/1.1 403 Forbidden
{
  "msg": "scope([shipping_address]) cannot be updated because it is set as 'Provision after collecting information through Kakao Account' but this information is not saved in Kakao Account of this user(1376016924429759243)",
  "code": -3
}

// HTTP/1.1 400 Bad Request
{
  "msg": "There is no scopes to upgrade. check out if given scope id([email]) is correct again.",
  "code": -2
}

// HTTP/1.1 403 Forbidden
{
  "msg": "scope([gender]) cannot be updated because this user(1376016924429759243) does not agree on Kakao Account terms for it.",
  "code": -3
}