# 鉴权方式

税务云api支持两种鉴权方式。若用户无法取得友互通accessToken,请使用税务云OpenAPI的appid加sign的鉴权方式。

# 友互通yht_access_token

接口权限鉴权使用友互通的accessToken作为身份验证权限。友互通accessToken可以放在url的参数中或者cookie中。

参数优先级为:

  1. cookie
  2. 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

开票类签名需要根据签名要求传入表单参数,其他类签名不需要,具体详见相关签名说明

Last Updated: 8/22/2023, 4:18:39 PM