# 鉴权方式
税务云api支持两种鉴权方式。若用户无法取得友互通accessToken,请使用税务云OpenAPI的appid加sign的鉴权方式。
# 友互通yht_access_token
接口权限鉴权使用友互通的accessToken作为身份验证权限。友互通accessToken可以放在url的参数中或者cookie中。
参数优先级为:
- cookie
- url param
例如,接口地址为:
https://{host}/bd/yyapi/hello
支持的url参数为:
https://{host}/bd/yyapi/hello?yht_access_token={token}
也支持cookie中包含token,cookie中参数名为yht_access_token
.
# 税务云OpenAPI签名
税务云OpenAPI签名格式要求包含appid和签名两部分。appid需要放置在URL上,签名值放置早请求header上。
# URL格式
URL需要在参数部分添加appid,appid值详见开通邮件内的appid值。
样例如下:
http://{HOST}:{PORT}/output-tax/api/invoice-his/print?appid=HelloTax
参数说明如下:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
appid | String | 是 | 签名appid值 |
# 签名值
签名值需要在Header中添加sign值,具体参数如下:
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
sign | String | 是 | 请求签名信息 |
TIP
开票类签名需要根据签名要求传入表单参数,其他类签名不需要,具体详见相关签名说明