图灵机器人用户生成接口对接协议v0-devstore.pdf

图灵机器人用户生成接口对接协议v1.0 2015-12-08 目录 1 接入方式 3 2 私钥 3 3 安全 3 4 参数列表 4 5 参数说明 4 6 返回参数 4 7 参数校验示例 5 8 操作流程 5 该接口为友商提供一个注册图灵用户的通道 【1】，当注册成功后可通过apikey 享有同图 灵官网注册用户 【2】相同的服务。 1 接入方式 通信协议，使用 HTTP 协议，支持 post 和 get 方式，推荐使用 get 方式接入。 2 私钥 约定私钥，双方本地保存。 key = MD5(tuling123) ；//图灵机器人域名. 3 安全 图灵为友商提供加密和不加密的两种解决方式（安全模式 【3】） 1 ）当使用不加密方式，只需要提供from 和 uid 两个字段即可 2 ）当使用加密方式，除from 和 uid 字段 【4】外还需要 token 字段进行验证 加密额外字段：token 4 参数列表 接入方传送的内容： /v1/member?from=XXXuid=XXXtoken=XX 注：如果不使用加密方式为： /v1/member?from=XXXuid=XXX 5 参数说明 接入方传入参数说明。 from ：约定的公钥（由图灵机器人提供） uid ：使用图灵服务的用户唯一标识 token ：校验字段，其加密方式为 = base64_encode(sha1(uid+key)) 6 返回参数 图灵机器人平台校验接入方传入的参数并做出以下反馈。 1 ）当使用不加密方式时 添加用户成功 {code:0,data:apikey} 添加用户失败（用户名或 apikey 已存在） {code:10002} 2 ）当使用加密方式时 校验token 成功并且添加用户成功 {code:0,data:apikey} 校验token 成功但是添加用户失败（用户名或 apikey 已存在） {code:10002} 校验token 失败 {code:10001} 7 参数校验示例 请接入方通过以下参数进行参数加密校验。 from= tuling123 uid = wx_123456; token = NjFkYjY5ZGEzYjc0ZGFiODA1ODQ2NWNlNmVkY2EwMTY1YTk3YmMwMA== 8 操作流程 1 ）友商提出申请，需要标注清楚 i 是否开启安全模式（是否使用 token 字段） ii 生成用户的等级（免费版用户还是标准版用户） 2 ）图灵审核通过后为友商提供公钥（即from 字段） 3 ）友商利用公钥并通过 api 接口创建图灵用户，当创建成功后即可通过 apikey 获取图灵 对话服务 说明： 1 ）目前注册图灵用户的方式分为 i 官网使用邮箱注册 ii 官网使用第三方账号登录 iii 使用本接口注册 2 ）目前图灵用户等级分为 i 免费版用户 ii 标准版用户，其中区别见 /html/extension.html 3 ）目前图灵为友商提供的接口安全模式分为 i 使用不加密方式 ii 使用加密方式 4 ）uid 为用户唯一标识，请使用字母、数字、下划线，长度控制在 200 个字符以内