第三方接入开发文档

写在前面

  • 氢软账户 SimID现已全面更新,旧版账户的开发文档与当前版本完全不同,请开发者完整阅读。
  • 如有疑问,可发邮件至ysh@simsoft.top咨询。
  • 氢软不受理由于目害导致的问题。
  • 操作教程

    第一步:申请应用

    请访问创建页面以创建一个应用。

    "站点名称"填写您的网站名称;

    "图标URL"请使用图片的完整直链,必须以https://开头,推荐使用正方形图标;

    "回调地址"请填写您的站点上的URL,必须以https://开头,您需要稍后在您的服务器上创建相应的文件以处理氢软给您发送的请求。

    第二步:引导用户至授权页

    应用管理页面点击您刚才创建的应用,点击“打开授权页”即可获得授权页地址。您需要在您的网站引导用户打开此页面以使用氢软登录。

    第三步:服务端处理

    当用户完成授权后,我们将使用用户的浏览器向您在第一步填写的回调地址发送一个GET请求。

    我们发送的请求中包含参数token。这个token作为用户的临时身份标识码使用,您需要请求氢软的服务器以获取用户的“真实身份”。

    收到此GET请求后,您的服务器需要向https://id.simsv.com/api/appverify.php?appid={你的APPID}&token={您的服务器收到的token}发送GET请求,我们将通过此API告诉你用户的真实身份。

    当用户正常授权后,您的服务器应该收到类似于以下返回内容:{ "code": 200, "usermail": "ysh@simsoft.top" }。JSON中usermail参数表示用户的真实邮箱,您可以使用此邮箱登录您的站点。

    当您的服务器的代码出现问题,您的服务器应该收到类似于以下返回内容:{ "code": 1000, "msg": "xxx" }。请根据msg参数的内容检查是否配置正确。

    如果用户操作出现问题,您的服务器应该收到类似于以下返回内容:{ "code": 1001, "msg": "xxx" }。请引导用户重新授权。