Comtrade API中subscription_key的含义、用法及密钥适配问询

1. subscription_key是什么？ #

subscription_key是Comtrade API的访问授权密钥，用于验证你的请求合法性，只有携带有效密钥的请求才能获取数据。你持有的primary key和secondary key都可以直接当作subscription_key使用，二者功能完全相同，secondary key主要作为备用选项，防止primary key泄露或失效时影响API调用。

2. 如何在API中使用它？ #

有两种常用方式：

• 直接传入参数：将你的primary key或secondary key字符串作为第一个参数传入bulkDownloadFinalFile函数，示例代码如下：

# 替换成你的primary/secondary密钥
my_key = "你的密钥内容"
comtradeapicall.bulkDownloadFinalFile(my_key, directory,
    typeCode='C', freqCode='M', clCode='HS',
    period='200001', reporterCode=251, decompress=True)

• 通过环境变量设置：设置系统环境变量COMTRADE_SUBSCRIPTION_KEY为你的密钥值，调用函数时可省略subscription_key参数，库会自动读取环境变量中的密钥：

comtradeapicall.bulkDownloadFinalFile(directory,
    typeCode='C', freqCode='M', clCode='HS',
    period='200001', reporterCode=251, decompress=True)

内容的提问来源于stack exchange，提问作者SSJ87