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)