号码包上传接口

最后更新时间:2021-12-27 18:01:37

    接口说明

    请求方式:POST。

    服务地址/v3/push/package/upload
    

    接口服务地址与服务接入点一一对应,请选择与您的应用服务接入点对应的 服务地址

    接口功能:用户需要通过文件的方式,对批量账号上传号码包文件。然后对号码包中的文件进行推送。号码包推送接口主要包括号码包上传接口、以及号码包推送接口。

    注意:

    • 账号包文件名:长度限制为 [1, 100]。
    • 账号包格式及大小: 支持 zip\txt\csv 文件;大小保持在100MB以内。
    • zip 压缩包中可包含:单个 .txt.csv 文件(不能嵌套文件夹)。
    • .txt 文件要求:(1)编码为 UTF-8;(2)每行一个账号,账号长度限制为 [2, 100]。
    • .csv 文件要求:(1)只能有一列;(2)每行一个账号,账号长度限制为 [2, 100]。

    请求参数

    参数名 类型 是否必须 参数说明
    file form-data
  • 账号包格式及大小: 支持 zip\txt\csv 文件;大小保持在100MB以内
  • zip 压缩包中可包含:单个 .txt.csv 文件(不能嵌套文件夹)
  • .txt 文件要求:(1)编码为 UTF-8;(2)每行一个账号,账号长度限制为 [2, 100]
  • .csv 文件要求:(1)只能有一列;(2)每行一个账号,账号长度限制为 [2, 100]
  • 响应参数

    参数名 类型 是否必须 参数说明
    retCode Integer 错误码
    errMsg String 请求出错时的错误信息
    uploadId Integer 当上传文件成功时,将反馈一个正整数 uploadId ,代表上传文件 ID,提供给后续号码包接口进行推送

    请求示例

    import base64
    from pip._vendor import requests
    from pip._vendor.urllib3 import encode_multipart_formdata

    def upload(url, filePath, accessId, secret, data={}, header={}):
    openFile = open(filePath, 'rb')
    data['file'] = (openFile.name, openFile.read())
    encode_data = encode_multipart_formdata(data)
    data = encode_data[0]
    header['Content-Type'] = encode_data[1]
    authInfo = accessId + ":" + secret

    header['Authorization'] = "Basic " + str(base64.b64encode(bytes(authInfo, encoding="utf8")),encoding="utf8")

    r = requests.post(url, headers=header, data=data)
    print(r.json())