快速接入
开发调试
API 列表
快速接入
开发调试
API 列表

三方平台手机号授权

1. 调用流转图

调用流转图 注意：手机号为用户隐私信息，数据请不要出聚石塔！

2. 接入步骤

2.1 三方平台申请对应权限包

  • 申请API调用权限包 getPhoneQuery
  • 申请对应的塔内TOP接口权限包 userPhoneQuery

2.2 调用端上API获取动态令牌code

  • 调用xy.getPhoneNumber()获取获取手机号动态令牌code 注：调用本api，需要使用闲鱼客户端版本≥ 7.18.20

【出参】：

属性 属性名称 类型 介绍
dynamicCode 动态令牌code String 动态令牌code

【错误码示例】：

{
    FAIL_BIZ_ISV_TYPE_PARAM_ILLEGA("type类型不合法"),

    FAIL_BIZ_COMMON_PARAM_MISS("缺少必填参数:%s")

    FAIL_BIZ_COMMON_NEED_LOGIN("亲，你还没有登录哦～")

    FAIL_BIZ_NO_XIAN_YU_USER("非闲鱼用户")

    FAIL_BIZ_NO_XIAN_YU_ISV_APP_KEY("非闲鱼三方小程序appKey")

    FAIL_BIZ_ISV_PHONE_NO_FIND("手机号不存在")

    FAIL_BIZ_ISV_DYNAMIC_CODE_GENERATE_FAIL("未生成token令牌")

    }

2.3 调用TOP接口获取对应真实手机号

  • 将上一步获取到的动态令牌code作为参数传入TOP接口，获取真实手机号。（接口调用的session用户信息需要和获取动态令牌code的登入用户一致）
  • 【接口】：alibaba.idle.isv.user.phone.query

【入参】：

属性 属性名称 类型 介绍
code 动态令牌code String 端上API返回到动态令牌code

【错误码示例】：

{
      USER_NO_LOGIN("用户未登入")

      NO_XIAN_YU_USER("非闲鱼用户")

      APP_KEY_IS_EMPTY("appKey为空")

      ISV_PHONE_NO_FIND("手机号不存在")

      ISV_DYNAMIC_CODE_VERIFY_FAIL("code有效性校验不通过")

      ISV_DYNAMIC_CODE_EXPIRED("code已过期，请重新生成")

      APP_KEY_IS_DIFFERENT("appKey与token令牌中的不一致")

      USER_ID_IS_DIFFERENT("userId与token令牌中的不一致") 
    }