안녕하세요, 카카오입니다.
서비스 보안 강화를 위해, 2026년 3월 19일부터 REST API 테스트 도구에서 어드민 키 인증 방식을 지원 종료합니다.
중요
본 변경은 REST API 테스트 도구에만 적용되며, 실제 API 스펙 및 인증 방식에는 변경 사항이 없습니다.
적용 일자
- 2026년 3월 19일 목요일
변경 사항
-
[도구] > [REST API 테스트]에서 인증 방식 중 하나인 어드민 키 방식 지원 종료됩니다.
-
각 API가 지원하는 인증 방식에 따라 아래와 같이 변경됩니다.
-
A. 어드민 키와 다른 인증 방식을 함께 지원하던 API → 테스트 도구에서 [어드민 키] 인증 옵션 제거
-
B. 어드민 키 인증 방식만 지원하던 API → 테스트 도구에서 해당 API 페이지 삭제
-
대상
A. 테스트 도구에서 어드민 키 인증 옵션이 제거되는 API
| 제품 | API | URI |
|---|---|---|
| 카카오로그인 | 로그아웃 | /v1/user/logout |
| 카카오로그인 | 연결 해제 | /v1/user/unlink |
| 카카오로그인 | 사용자 정보 조회 | /v2/user/me |
| 카카오로그인 | 배송지 조회 | /v1/user/shipping_address |
| 카카오로그인 | 동의항목 동의 내역 확인 | /v2/user/scopes |
| 카카오로그인 | 동의항목 동의 철회 | /v2/user/revoke/scopes |
| 카카오로그인 | 서비스 약관 동의 내역 조회 | /v2/user/service_terms |
| 카카오로그인 | 서비스 약관 동의 철회 | /v2/user/revoke/service_terms |
| 카카오로그인 | 고급: 서비스 약관에 동의 | /v2/user/upgrade/service_terms |
| 카카오톡 채널 | 카카오톡 채널 관계 조회 | /v2/api/talk/channels |
B. 테스트 페이지가 삭제되는 API
| 제품 | API | URI |
|---|---|---|
| 카카오로그인 | 여러 사용자 정보 조회 | /v2/app/users |
| 카카오로그인 | 사용자 목록 조회 | /v1/user/ids |
| 카카오톡 채널 | 여러 사용자 카카오톡 채널 관계 조회 | /v2/api/talk/channels/multi |
| 톡 캘린더 | 공개 일정 생성 | /v2/api/calendar/public/create/event |
| 톡 캘린더 | 공개 일정 목록 조회 | /v2/api/calendar/public/events |
| 톡 캘린더 | 공개 일정 상세 조회 | /v2/api/calendar/public/event |
| 톡 캘린더 | 공개 일정 수정 | /v2/api/calendar/public/update/event |
| 톡 캘린더 | 공개 일정 삭제 | /v2/api/calendar/public/delete/event |
| 톡 캘린더 | 구독 가능 캘린더 목록 조회 | /v2/api/calendar/subscribable/calendars |
| 톡 캘린더 | 공휴일 및 주요 기념일 조회 | /v2/api/calendar/holidays |
| 푸시 알림 | 푸시 토큰 등록 | /v2/push/register |
| 푸시 알림 | 푸시 토큰 조회 | /v2/push/tokens |
| 푸시 알림 | 푸시 토큰 삭제 | /v2/push/deregister |
| 푸시 알림 | 푸시 알림 발송 | /v2/push/send |
조치 사항
-
어드민 키 인증 방식은 REST API 테스트 도구에서 제공되지 않으니, curl, Postman 등 HTTP 클라이언트 도구를 사용해 테스트해 주세요.
-
REST API 테스트 도구를 이용하지 않는 경우, 별도 조치는 필요하지 않습니다.
참고
관련하여 궁금하신 점은 데브톡으로 문의해 주시기 바랍니다.
언제나 더 좋은 서비스를 제공하기 위해 최선을 다하겠습니다.
감사합니다.
카카오디벨로퍼스 드림
Hello, it’s Kakao.
To enhance service security, Admin Key authentication method will be discontinued in the REST API test tool starting March 19, 2026.
Important
This change applies only to the REST API Test Tool.
There are no changes to the actual API specifications or authentication methods.
Effective Date
- Thursday, March 19, 2026
Changes
-
The Admin Key authentication method will be discontinued in the [Tools] > [REST API Test].
-
Depending on the authentication methods supported by each API, the REST API Test Tool will change as follows:
-
A. APIs that supported Admin Key and other authentication methods
→ The [Admin Key] authentication option will be removed from the test tool. -
B. APIs that supported only the Admin Key authentication method
→ The test page for the API will be removed from the test tool.
-
Scope of Impact
A. APIs with the Admin Key option removed from the test tool
| Product | API | URI |
|---|---|---|
| Kakao Login | Logout | /v1/user/logout |
| Kakao Login | Unlink | /v1/user/unlink |
| Kakao Login | Get user information | /v2/user/me |
| Kakao Login | Get shipping address | /v1/user/shipping_address |
| Kakao Login | Get consent details | /v2/user/scopes |
| Kakao Login | Revoke consent | /v2/user/revoke/scopes |
| Kakao Login | Get consent details for service terms | /v2/user/service_terms |
| Kakao Login | Revoke consent for service terms | /v2/user/revoke/service_terms |
| Kakao Login | Set consent to service terms | /v2/user/upgrade/service_terms |
| Kakao Talk Channel | Check Kakao Talk Channel relationship | /v2/api/talk/channels |
B. APIs with the test page removed from the test tool
| Product | API | URI |
|---|---|---|
| Kakao Login | Retrieve multiple user information | /v2/app/users |
| Kakao Login | Retrieve user list | /v1/user/ids |
| Kakao Talk Channel | Check multiple users’ Kakao Talk Channel relationship | /v2/api/talk/channels/multi |
| Talk Calendar | Create public event | /v2/api/calendar/public/create/event |
| Talk Calendar | Retrieve list of public events | /v2/api/calendar/public/events |
| Talk Calendar | Retrieve details of public event | /v2/api/calendar/public/event |
| Talk Calendar | Edit public event | /v2/api/calendar/public/update/event |
| Talk Calendar | Delete public event | /v2/api/calendar/public/delete/event |
| Talk Calendar | Retrieve list of subscribable calendars | /v2/api/calendar/subscribable/calendars |
| Talk Calendar | Retrieve holidays and celebrations | /v2/api/calendar/holidays |
| Push Notification | Register push token | /v2/push/register |
| Push Notification | Retrieve push token | /v2/push/tokens |
| Push Notification | Delete push token | /v2/push/deregister |
| Push Notification | Send push notifications | /v2/push/send |
Required Action
-
Use HTTP client tools (Example: curl, Postman) to test API requests directly with the Admin Key.
Admin Key authentication is no longer available in the REST API Test Tool. -
If you do not use the REST API Test Tool, no action is required.
References
If you have any questions, please contact us via DevTalk.
Thank you.
Kakao Developers