Moka API
    Moka API
    • OAUTH2单点登录
    • MOKA通用单点登录
    • CAS单点登录
      • 流程图
      • 流程说明
      • MOKA登录url
        GET
      • 客户登录url
        GET
      • 请求客户ticket校验url
        GET
    • Offer API
      • 获取offer自定义字段列表
        POST
    • 用户 API
      • 同步人事信息
        POST
    • 候选人 API
      • 获取候选人信息v2接口
        POST
      • 获取招聘流程列表
        GET
      • 获取阶段信息列表
        GET
    • 人才库 API
      • 人才库数据导入
        GET
    • 组织架构 API
      • 组织架构全量同步
        PUT
      • 组织架构增量同步
        POST
      • 更新组织架构
        POST
    • 考试/测评、背调、视频面试接入指南
      • 整体流程图/flowchart
      • 绑定认证/Oauth
        • 绑定步骤
        • 认证所需接口
          • moka认证页面
          • 获取accessToken
          • 刷新accessToken
          • 开放平台解绑
          • 开放平台推送token
        • 服务商信息
          • 更新logo信息
          • 更新账户名信息
      • 考试/测评
        • 业务流程图
        • Moka请求第三方供应商API
          • 创建考试
        • 第三方供应商请求Moka API
          • 余额
          • 全量试同步试卷列表
          • 更新试卷
          • 删除试卷
          • 成绩回传
      • 背调
        • 业务流程图
        • Moka请求第三方供应商API
          • 创建背调
          • 取消背调
        • 第三方供应商请求Moka API
          • 第三方供应商请求Moka API
          • 余额
          • 自定义字段
          • 全量套餐列表
          • 更新套餐
          • 删除套餐
          • 结果回传
          • 背调进度阶段回传
          • 回传候选人信息
      • 视频面试
        • Moka请求第三方供应商API
          • 创建视频面试
          • 创建面试V2版本
          • 修改面试V2版本
          • 取消面试
        • 第三方供应商请求Moka API
          • 第三方供应商请求Moka API
          • 余额
          • 自定义字段
          • 全量套餐列表
          • 更新套餐
          • 删除套餐
          • 结果回传
          • 背调进度阶段回传
          • 回传候选人信息

    OAUTH2单点登录

    开放授权的一个标准

    a、流程图#

    单点登录

    b、流程说明#

    MOKA提供#

    1.
    moka会提供一个登录url。
    1.1 例：https://app.mokahr.com/login_by/oauth2/orgId
    2.
    moka会提供一个回调地址
    2.1 例：https://app.mokahr.com/login_by/oauth2/orgId/landing

    客户提供#

    1.
    客户需要提供自己的授权url。
    1.1 例：https://www.third.com/oauth/authorize
    2.
    客户需要提供自己的获取token url。
    2.1 例：https://www.third.com/oauth/token
    3.
    客户需要提供自己的获取用户信息 url。
    3.1 例：https://www.third.com/user

    跳转流程#

    1.
    客户在自己的系统中配置moka提供的登录url
    2.
    点击moka登录url时。moka会重定向到客户的授权页面
    3.
    客户在授权页面填写账号密码进行登录，登录成功后带着code跳转到moka的回调地址
    4.
    moka通过code调用客户的token接口获取token
    5.
    moka通过获取到的token调用客户的获取用户信息接口获取客户的用户信息
    6.
    获取到客户的用户信息后进行登录

    c、MOKA登录url说明#

    url说明#

    通过访问此接口，跳转到到MOKA

    HTTP 接口#

    GET https://app.mokahr.com/login_by/oauth2/{orgId}

    请求Path参数#

    字段必填类型描述
    orgId是string每个公司客户对应的唯一id，联系实施或csm获取。

    请求Query#

    字段必填描述
    ifGoRecommendWeb否moka通过该参数来判断客户是否跳转到内推页面。 1、不传该参数时默认按照角色跳转。 2、传固定值 '1' 时跳转内推官网。 3、优先级高于returnUrl
    returnUrl否登录成功后跳转的地址。 1、不传该参数时则默认跳转到对应角色的首页。 2、传该参数时登录成功后会跳转到该地址。 3、优先级低于ifGoRecommendWeb

    请求结果#

    moka接收到请求后，会调用客户的授权url，跳转到客户的授权登录页面

    d、MOKA回调地址url说明#

    url说明#

    客户授权之后，需要带着code重定向到该地址。

    HTTP 接口#

    GET https://app.mokahr.com/login_by/oauth2/{orgId}/landing

    请求Path参数#

    字段必填类型描述
    orgId是string每个公司客户对应的唯一id，联系实施或csm获取。

    请求Query#

    字段必填描述
    code是客户授权码code
    state是moka重定向到客户授权页面时携带的参数，授权成功后需要原封不动的传回来
    ifGoRecommendWeb否moka通过该参数来判断客户是否跳转到内推页面。 1、不传该参数时默认按照角色跳转。 2、传固定值 '1' 时跳转内推官网。 3、优先级高于returnUrl
    returnUrl否登录成功后跳转的地址。 1、不传该参数时则默认跳转到对应角色的首页。 2、传该参数时登录成功后会跳转到该地址。 3、优先级低于ifGoRecommendWeb

    e、客户授权url说明#

    url说明#

    客户的授权url，客户需要在该页面填写账号密码进行登录

    HTTP 接口#

    GET https://www.third.com/oauth/authorize （客户提供的登录地址）

    请求Path参数#

    无

    请求Query#

    字段必填描述
    responseType是固定值 code
    clientId是应用id。 1、该参数由客户提供
    redirectUri是回调地址。授权成功后的重定向地址。 1、该参数由moka提供
    scope是授权范围。 1、该参数由客户提供
    state是授权成功后，重定向到回调地址时需要携带该参数 1、该参数由moka提供

    f、客户获取令牌url说明#

    url说明#

    客户的授权url，客户需要在该页面填写账号密码进行登录

    HTTP 接口#

    GET https://www.third.com/oauth/token （客户提供的登录地址）

    请求Path参数#

    无

    请求Query#

    字段必填描述
    clientId是应用id。 1、该参数由客户提供
    clientSecret是应用secret。 1、该参数由客户提供
    grantType是授权方式。固定值authorization_code。
    code是上一步授权后获取到的授权码code。
    redirectUri是令牌token颁发后的回调网址。 1、该参数由moka提供

    返回结果#

    字段字段必填描述
    codenumber是接口状态码。0: 成功
    msgstring是接口调用说明
    dataobject是返回值
    data.accessTokenstring是令牌token
    data.expiresInstring是令牌过期时间
    data.refreshTokenstring是令牌刷新token

    g、客户获取用户信息url说明#

    url说明#

    客户的获取用户信息接口url，可以通过该接口获取授权客户的用户信息

    HTTP 接口#

    GET https://www.third.com/user （客户提供的登录地址）

    请求Path参数#

    无

    请求Query#

    字段必填描述
    accessToken是令牌token。通过token接口获取

    返回结果#

    字段字段必填描述
    codenumber是接口状态码。0: 成功
    msgstring是接口调用说明
    dataobject是返回值
    data.emailstring是客户邮箱

    【Moka】API开发者 微信交流群

    用微信扫右侧二维码，加入【Moka】API开发者 交流群，互助沟通

    扫码加入交流群
    修改于 2021-11-15 13:32:28
    下一页
    MOKA通用单点登录
    Built with