服务凭证 API - 云银签合同签署系统

服务凭证

服务凭证API允许您获取和管理访问云银签API所需的访问令牌(Access Token)。所有对API的请求都需要在请求头中包含有效的Access Token。

POST /service/getAccessToken 获取服务凭证

通过应用ID和密钥获取访问凭证，用于后续API调用的身份验证。

请求参数

参数名	类型	位置	必填	描述
appId	string	body	是	应用ID，在开发者平台获取
appSecret	string	body	是	应用密钥，在开发者平台获取

请求示例

CURL

Java

Python

curl -X POST 'https://api.yyq.com/service/getAccessToken' \
  -H 'Content-Type: application/json' \
  -d '{
    "appId": "your_app_id",
    "appSecret": "your_app_secret"
  }'

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

// 构建请求体
String requestBody = "{\"appId\":\"your_app_id\",\"appSecret\":\"your_app_secret\"}";

// 创建HTTP请求
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.yyq.com/service/getAccessToken"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(requestBody))
    .build();

// 发送请求
HttpResponse response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

// 处理响应
System.out.println(response.body());

import requests
import json

url = "https://api.yyq.com/service/getAccessToken"
headers = {
    "Content-Type": "application/json"
}
data = {
    "appId": "your_app_id",
    "appSecret": "your_app_secret"
}

response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.json())

响应

成功响应

错误响应

{
  "code": "0",
  "msg": "success",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expiresIn": 1686096000000,
    "corpId": 12345
  }
}

{
  "code": "401",
  "msg": "应用ID或密钥不正确",
  "data": null
}

错误码

错误码	描述
401	应用ID或密钥不正确
403	应用没有权限
500	服务器内部错误