获取AccessToken(影像系统)

测试环境(除税控、数电和扫码开票外的接口）

https://api-dev.piaozone.com/test

POST

/archivebase/scan/login/token

调用影像的因为接口之前，都需要先获取token，然后在每个业务接口的地址栏拼上此token，用于身份和权限验证

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

clientId

string

客户端id

必需

商户注册后，系统会自动生成一个随机的字符串作为client_id；（clientId用企业级别）

sign

string

签名

必需

详情见对接约定中的签名规则部分

timestamp

integer

时间戳

必需

fsource

integer

操作系统来源

必需

1-发票云 2-eas 3-星空 4-苍穹 5-OA 6-国信 7-道克维斯 8-单多啦 9-优易迅 10-金茂 15-汉德 99-其他

fuserName

string

用户名称

必需

当前操作用户的姓名

fphoneNumber

string

用户手机号码

必需

当前操作用户的手机号码

feasUid

string

用户唯一ID

必需

当前操作用户在对接系统的用户唯一ID

ftaxNo

string

组织企业

必需

当前操作用户在对接系统所属的组织企业税号

language

string

语言版本

必需

默认中国, zh-CN:中国、en-US:美国、es-ES :西班牙、fr-FR:法国、de-DE :德国

示例

{
    "clientId": "Ng%3cb3&1k9ohHFmo%[u",
    "sign": "]r6Eb2u3EWHQc*N#iI7Z&hgBc]l#8Q%g",
    "timestamp": 1716952339,
    "fsource": 2,
    "fuserName": "林刚",
    "fphoneNumber": "18125684174",
    "feasUid": "7mo5GiwZekuGiBNk!#Zn",
    "ftaxNo": "npsp4dv)QJX)(Z8w&C",
    "language": "zh-CN"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-dev.piaozone.com/test/archivebase/scan/login/token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clientId": "Ng%3cb3&1k9ohHFmo%[u",
    "sign": "]r6Eb2u3EWHQc*N#iI7Z&hgBc]l#8Q%g",
    "timestamp": 1716952339,
    "fsource": 2,
    "fuserName": "林刚",
    "fphoneNumber": "18125684174",
    "feasUid": "7mo5GiwZekuGiBNk!#Zn",
    "ftaxNo": "npsp4dv)QJX)(Z8w&C",
    "language": "zh-CN"
}'

返回响应

🟢200成功

application/json

Body

errcode

string

状态码

必需

0000标识成功，非0000都属于失败，失败原因见描述

description

string

描述

必需

操作结果描述

data

object

必需

accessToken

string

accessToken

必需

accessToken，用于调用其他业务接口使用

expiresTime

integer

过期时间

必需

accessToken剩余过期时间，毫秒为单位

topic

string

必需

示例

{
    "errcode": "0000",
    "description": "操作成功",
    "data": {
        "accessToken": "5x7fx8vl526i484qs7h622jxdm3m5lau",
        "expiresTime": 72000,
        "topic": "影像支撑系统token"
    }
}

修改于 2024-07-22 06:04:46

影像系统对接

档案