APIPOST上传文件详解

一、接口介绍

APIPOST上传文件接口是一种快捷、安全、稳定的文件上传方式。在使用APIPOST上传文件之前，您需要前往APIPOST官网创建账号，并在账号中生成access_key和access_secret。这些信息将在APIPOST上传文件接口中作为参数使用，以便进行身份验证和授权。

使用APIPOST上传文件不仅可以节省文件上传时间，而且能够自动处理文件的格式验证、加密、解密等操作。此外，APIPOST上传文件还提供了多种上传方式，包括本地上传、远程上传和资源百度热度统计。

二、本地上传方式

本地上传指的是您将要上传的文件保存在本地，然后调用APIPOST上传文件接口将文件上传至服务器。其主要优点是操作简单快捷，无需进行复杂的配置；但其缺点是可能会受到网络环境的影响，导致上传失败或上传速度受到限制。

代码示例

import requests
import hashlib
import hmac
import base64

access_key = "your_access_key"
access_secret = "your_access_secret"
bucket_name = "your_bucket_name"
file_path = "your_local_file_path"
url = "http://api.apipost.cn/upload"

def calc_sign(access_secret, content):
    sign = hmac.new(access_secret.encode("utf-8"), content.encode("utf-8"), hashlib.sha1).digest()
    sign = base64.b64encode(sign).decode("utf-8")
    return sign

def upload_file(access_key, access_secret, bucket_name, file_path, url):
    with open(file_path, "rb") as f:
        file_data = f.read()
    file_name = file_path.split("/")[-1]
    headers = {
        "apipost-bucket-name": bucket_name,
        "apipost-file-name": file_name,
        "apipost-access-key": access_key,
        "apipost-file-hash": hashlib.sha1(file_data).hexdigest(),
        "apipost-file-size": str(len(file_data)),
    }
    content = '\n'.join((
            headers["apipost-bucket-name"],
            headers["apipost-file-name"],
            headers["apipost-access-key"],
            headers["apipost-file-hash"],
            headers["apipost-file-size"]
            ))
    headers["apipost-signature"] = calc_sign(access_secret, content)
    response = requests.post(url, data=file_data, headers=headers)
    return response

response = upload_file(access_key, access_secret, bucket_name, file_path, url)
print(response.text)

三、远程上传方式

远程上传指的是您将要上传的文件保存在第三方服务器上，然后调用APIPOST上传文件接口将文件从远程服务器上上传至APIPOST服务器。与本地上传方式相比，远程上传方式更加方便，同时也减少了您的服务器压力。但其缺点是上传速度可能受到远程服务器带宽的限制。

代码示例

import requests
import hashlib
import hmac
import base64

access_key = "your_access_key"
access_secret = "your_access_secret"
bucket_name = "your_bucket_name"
file_url = "your_remote_file_url"
url = "http://api.apipost.cn/upload"

def calc_sign(access_secret, content):
    sign = hmac.new(access_secret.encode("utf-8"), content.encode("utf-8"), hashlib.sha1).digest()
    sign = base64.b64encode(sign).decode("utf-8")
    return sign

def remote_upload(access_key, access_secret, bucket_name, file_url, url):
    headers = {
        "apipost-bucket-name": bucket_name,
        "apipost-file-url": file_url,
        "apipost-access-key": access_key,
        "apipost-file-hash": "",
        "apipost-file-size": "",
    }
    content = '\n'.join((
            headers["apipost-bucket-name"],
            headers["apipost-file-url"],
            headers["apipost-access-key"],
            headers["apipost-file-hash"],
            headers["apipost-file-size"]
            ))
    headers["apipost-signature"] = calc_sign(access_secret, content)
    response = requests.post(url, headers=headers)
    return response

response = remote_upload(access_key, access_secret, bucket_name, file_url, url)
print(response.text)

四、资源百度热度统计

APIPOST上传文件接口还提供资源百度热度统计功能，能够自动获取文件的访问量、下载量等指标数据。使用资源百度热度统计需要进行额外的配置和付费，同时也需要对文件的格式、访问链接和访问方式进行特殊处理。

代码示例

import requests
import hashlib
import hmac
import base64

access_key = "your_access_key"
access_secret = "your_access_secret"
bucket_name = "your_bucket_name"
file_path = "your_file_path"
url = "http://api.apipost.cn/upload"

def calc_sign(access_secret, content):
    sign = hmac.new(access_secret.encode("utf-8"), content.encode("utf-8"), hashlib.sha1).digest()
    sign = base64.b64encode(sign).decode("utf-8")
    return sign

def upload_file(access_key, access_secret, bucket_name, file_path, url):
    with open(file_path, "rb") as f:
        file_data = f.read()
    file_name = file_path.split("/")[-1]
    headers = {
        "apipost-bucket-name": bucket_name,
        "apipost-file-name": file_name,
        "apipost-access-key": access_key,
        "apipost-file-hash": hashlib.sha1(file_data).hexdigest(),
        "apipost-file-size": str(len(file_data)),
        "apipost-bdpv": "true",
        # "apipost-source-url": "your_file_source_url",
        # "apipost-codec": "your_file_codec",
    }
    content = '\n'.join((
            headers["apipost-bucket-name"],
            headers["apipost-file-name"],
            headers["apipost-access-key"],
            headers["apipost-file-hash"],
            headers["apipost-file-size"],
            headers["apipost-bdpv"],
            # headers["apipost-source-url"],
            # headers["apipost-codec"],
            ))
    headers["apipost-signature"] = calc_sign(access_secret, content)
    response = requests.post(url, data=file_data, headers=headers)
    return response

response = upload_file(access_key, access_secret, bucket_name, file_path, url)
print(response.text)