跳到主要内容

网站应用接入

提示

如果你还没创建应用,请先到控制台 -> 应用管理 新建得到应用ID和应用Secret再继续。

如果你还没配置回调URI,请先到控制台 -> 应用管理 -> OAuth设置 配置好再继续。

获取Auth Code

登录按钮

应用界面展示登录按钮,文案为:"用唯ID登录",左侧添加唯ID logo,主题色为 #3F51B5

两种参考样式(推荐左侧,更正式更清晰):

提示:logo素材请从上面两个按钮右键另存为获取。

跳转OAuth页

用户点击登录按钮后,跳转至登录授权页:

GET https://onlyid.net/oauth?client-id=你的应用ID&redirect-uri=你的应用回调URI HTTP/1.1
提示

回调URI应使用 encodeURIComponent 方法转码后再使用。

可使用 window.open 方法以小窗口形式打开登录页,以获得更好体验。

示例:

GET https://onlyid.net/oauth?client-id=98d44b4a3543db79&redirect-uri=https%3A%2F%2Fwww.example.com%2Fmy-app%2Foauth-callback HTTP/1.1

待用户在登录授权页完成认证,唯ID会生成auth code重定向到你的回调URI,成功示例:

GET https://www.example.com/my-app/oauth-callback?code=6e4de248e9223c9d HTTP/1.1

获取用户信息

得到auth code后,通过code换取用户信息的逻辑三端一致(Web、Android、iOS),详见 获取用户信息

示例Demo

请访问GitHub参考 示例Demo(Web)