• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 支付
  • 交易系统
  • 担保支付(即将下线)
  • 进件
  • 发起进件请求
  • 图片上传接口
  • 进件状态查询
  • 进件状态回调
  • 支付
  • 退款
  • 结算及分账
  • 退分账
  • 提现
  • 获取对账单
  • 接口获取页面链接
  • 订单推送
  • 评价
  • 抖店绑定
  • 交易工具
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 发起进件请求需要上传商户证件等图片,需要先调用图片上传接口获取 image_id。

    使用限制

    接口说明

      1.请求参数必须使用 form 表单格式。

    基本信息

    基本信息
    HTTP URL
    HTTP Method
    POST
    接口频次
    20QPS(小程序app_id维度或者thirdparty_id纬度)

    请求头

    名称
    类型
    必填
    描述
    Content-Type
    string
    固定值 "multipart/form-data"

    请求参数

    名称
    类型
    是否必填
    最大长度
    描述
    示例值
    app_id
    string
    条件选填
    64
    小程序的 app_id
    在开发者身份下必填
    ttdb96ad2b44aeff3301
    access_token
    string
    条件选填
    64
    小程序token
    在开发者身份下必填
    567234784
    thirdparty_id
    string
    条件选填
    64
    小程序第三方平台应用 id
    在服务商身份下必填
    ttc4a8b2155b82682f
    component_access_token
    string
    条件选填
    64
    服务商绑定的token
    在服务商身份下必填
    "8431201934ab"
    image_type
    string
    64
    图片格式,支持格式:jpg、jpeg、png
    jpg
    image_content
    byte_array
    2097152
    图片二进制字节流,最大为2M

    请求示例

    key
    value
    app_id
    ttdb96ad2b44aeff3301
    access_token
    567234784
    image_type
    jpg
    image_content
    010101

    响应参数

    公共响应参数

    名称
    类型
    是否必填
    最大长度
    描述
    示例值
    error_no
    number
    -
    返回码,详见错误码及错误描述
    2008
    error_tips
    string
    -
    返回码描述,详见错误码及错误描述
    签名校验异常,请使用正确的签名和 json 传参

    业务响应参数

    名称
    类型
    是否必填
    最大长度
    描述
    示例值
    image_id
    string
    256
    图片在文件存储平台的标识
    6523.jpeg

    响应示例

    正常响应示例

    { "err_no": 0, "err_tips": "", "image_id": "6523.jpeg" }

    异常异常示例

    { "err_no": 2008, "err_tips": "签名校验异常,请使用正确的签名和 json 传参", "image_id": "" }

    错误码

    错误码
    err_no
    描述
    err_tips
    排查建议
    0
    ""
    上传成功
    2008
    签名校验异常,请使用正确的签名和 json 传参
    请检查app_id和access_token或者thirdparty_id和component_access_token的正确性
    7004
    超过单个图片允许的限制(2M)
    请适当压缩图片大小以免超过上传限制
    7005
    图片文件为空
    商户更换文件后,重新调用
    7006
    未知图片类型
    图片类型必须为JPG, PNG,JPEG