Naver Developers
应用注册
要使用 Naver 登录、搜索、Papago、地图、本地搜索等 Naver 开放 API,需要在 Naver Developers 注册应用。 从应用注册、密钥发放到成员管理为您指导。
注册费
免费
审核
即时(部分 API 需审核)
所需
Naver 账号
Overview
开始前请先确认
Naver Developers 免费注册应用,大多数 API 可立即使用。NAVER Maps 已迁移至 Naver Cloud Platform,需要单独注册 — 请不要与本指南混淆。
准备 Naver 账号
建议使用实名认证账号。
确定服务 URL
先确定网页服务域名。
隐私政策
Naver 登录审核必备。
了解各 API 差异
地图 API 需 NCP 单独注册。
Step by Step
分步指南
SIGNUP
Naver 账号 + 开发者注册
在 developers.naver.com 用 Naver 账号登录。
- 使用已实名认证的账号登录
- 首次登录需同意开发者使用条款
- 开发者中心随即启用
CREATE APP
注册应用
我的应用 > 注册应用。
- 填写应用名称
- 勾选所用 API(搜索/Naver 登录/Papago/日历 等)
- 注册非登录开放 API 服务环境
- 环境:WEB / Android / iOS 选择对应平台
KEYS
查看 Client ID / Secret
注册完成后自动发放应用密钥。
- Client ID:可公开(可在前端使用)
- Client Secret:仅限服务端 · 严禁暴露
- 可在应用信息中查看或重新发放
- 建议放入 .env 文件管理
PLATFORM
注册平台 / Callback URL
按所选平台分别填写信息。
- WEB:服务 URL + Callback URL(Naver 登录时)
- Android:包名 + 下载 URL
- iOS:Bundle ID + App Store URL
- Callback URL 不匹配将返回 401
AUTH
配置 Naver 登录权限
使用 Naver 登录时设置必要项。
- 指定必填/可选提供信息(姓名、邮箱、昵称、头像等)
- 联系方式、生日、性别等需要提交审核
- 审核时需提交使用目的与隐私政策 URL
- 审核周期:工作日 1–3 天
API
调用 搜索 · Papago · Clova API
普通开放 API 仅需 Client ID/Secret 头部即可立即调用。
- 请求头:X-Naver-Client-Id、X-Naver-Client-Secret
- 搜索 API(博客·咖啡·新闻·图片等)日免费 25,000 次
- Papago 翻译:每月 10,000 字符免费,超出需付费
- 开发时注意 rate limit(建议每秒 10 次)
MAP
NAVER 地图(NCP 单独注册)
地图 API 已迁移到 Naver Cloud Platform。
- 需在 https://console.ncloud.com 单独注册
- AI·NAVER API 产品 > Maps > 申请使用
- Geocoding / Reverse Geocoding / Directions / Static Maps
- 发放 Client ID 后在 Web Dynamic Map JS SDK 使用
- 免费额度:每月 100 万次(产品各异)
MANAGE
邀请成员与用量监控
在应用设置中管理团队与监控。
- 应用信息 > 成员管理 > 邀请
- 成员用对应 Naver 账号登录后可访问应用
- 查看每日 API 调用量图表
- 超额会导致调用失败 — 请预留余量
Pitfalls
常见卡点
NAVER 地图 ≠ Naver Developers
地图需要在 Naver Cloud Platform(console.ncloud.com)注册。在 Naver Developers 找不到地图入口。
Client Secret 暴露在前端
把 Client Secret 直接写入示例代码并发布的错误很常见。请务必通过服务端或代理调用。
将需审核字段设为必填
联系方式、地址、生日等在审核完成前不会出现在响应中。勾选必填前请先申请审核。
Callback URL 不一致
注册 URL 与实际重定向 URL 必须完全一致,协议(http/https)与末尾斜杠也会被区分。
超出 API 日额度
超过免费额度后调用会被阻断。Papago、搜索需升级付费套餐。