Kakao Developers
应用注册与密钥发放
要使用 Kakao 登录、地图、AlimTalk、分享等 Kakao API,需要在 Kakao Developers 注册应用。 从应用创建、密钥发放到平台配置,按顺序为您指导。
注册费
免费
审核
即时
所需
Kakao 账号
Overview
开始前请先确认
Kakao Developers 免费注册,但部分功能(Kakao 登录同意项、AlimTalk、Biz Message)需要额外申请与审核。应用密钥千万不要暴露在客户端 — Admin 密钥仅限服务端使用。
准备 Kakao 账号
需完成邮箱/手机验证。
确定服务域名
网页服务请先确定域名。
隐私政策 URL
Kakao 登录审核必填。
企业账号(可选)
如需 AlimTalk/Biz Message。
Step by Step
分步指南
SIGNUP
Kakao 账号 + 开发者注册
登录 Kakao Developers 并注册为开发者。
- 访问 developers.kakao.com → 右上角登录
- 首次登录需同意开发者使用条款
- 必须完成邮箱/手机验证
CREATE APP
创建我的应用
填写应用基本信息。
- 我的应用 > 添加应用
- 应用图标(至少 128×128,建议 PNG)
- 应用名称(显示在 KakaoTalk 分享与登录界面)
- 企业名称 / 分类
KEYS
查看应用密钥并做好保护
系统自动发放 4 种应用密钥。
- Native 应用密钥:iOS/Android 原生 SDK 使用
- JavaScript 密钥:Web JS SDK 使用(必须限制域名)
- REST API 密钥:服务端 REST 调用使用
- Admin 密钥:用户管理 API · 严禁暴露到客户端
- 密钥泄露后可在应用设置中重新发放
PLATFORM
注册平台
注册应用运行平台信息。
- Android:包名 + 密钥哈希(keystore SHA1 → Base64)
- iOS:Bundle ID
- Web:站点域名(可注册多个,含 http://localhost)
- 未注册的平台 SDK 调用会失败
AUTH
启用 Kakao 登录
使用 Kakao 登录时需启用并注册 Redirect URI。
- 产品设置 > Kakao 登录 > 启用
- 启用 OpenID Connect(需要 JWT 令牌时)
- 注册 Redirect URI(仅网页需要,原生依赖应用密钥)
- 设置同意项(昵称、头像、邮箱、年龄段等)
- 必需同意需审核,可选同意可立即使用
REVIEW
同意项审核申请(如需)
邮箱、生日、性别等部分项需转为 Biz 应用并通过审核后方可使用。
- 转为 Biz 应用:上传营业执照
- 必须注册隐私政策 URL
- 可审核项:邮箱、生日、出生年、性别、联系方式、地址等
- 审核周期:工作日 1–5 天
MESSAGE
KakaoTalk 消息 / 分享
消息 API 设置,与 AlimTalk 不同。
- 产品设置 > KakaoTalk 消息 > 启用
- 模板构建器创建分享/消息模板
- 使用模板 ID 通过原生/JS SDK 发送
- 实际发送消息需要接收方同意(talk_message)权限
ALIMTALK
AlimTalk(可选·单独申请)
AlimTalk 不通过 Kakao Developers,需通过 Biz Message 平台(NHN、Aligo 等)发送。
- Kakao Business > 先开通 KakaoTalk 频道
- 完成频道企业认证
- 与 NHN Cloud、Aligo、Swingpham 等发送代理签约
- 模板由 Kakao 直接审核(工作日 1–2 天)
- 按条计费约 8~10 韩元
Pitfalls
常见卡点
密钥哈希不一致(Android)
debug 与 release keystore 的 SHA1 不同。必须同时注册两个哈希,发布版的 Kakao 登录才能正常。
JavaScript 密钥未限制域名
开放所有域名会被他人盗用。请在平台 > 网页处明确允许的域名。
Admin 密钥暴露到客户端
Admin 密钥被上传到 GitHub 公共仓库的事故频发。请放到 .env 并确认 gitignore。
未审核即将邮箱设为必需同意
未审核将邮箱设为必需会导致登录报错。请先转 Biz 应用并完成审核。
AlimTalk 与 FriendTalk 混淆
AlimTalk 为信息性(无需同意);FriendTalk 为广告性(仅限频道好友)。按场景选择。