创建核销端应用

POST

/v1/internal/apps

一个 app 对应一套开放接口访问 key/secret。
如果请求中未传 client_key 或 secret，服务端会自动生成。
返回体中的 secret 仅在创建成功时返回一次。

请求参数

Authorization

API Key

在 header 添加参数

X-XTJ-UID

示例：

X-XTJ-UID: ********************

Body 参数application/json必填

示例

{
    "name": "string",
    "code": "string",
    "description": "string",
    "client_key": "string",
    "secret": "string",
    "status": "active",
    "allow_token_read": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/internal/apps' \
--header 'X-XTJ-UID: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "code": "string",
    "description": "string",
    "client_key": "string",
    "secret": "string",
    "status": "active",
    "allow_token_read": true
}'

返回响应

🟢201已创建

application/json

创建成功

Body

示例

{
    "data": {
        "app": {
            "id": 0,
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z",
            "name": "string",
            "code": "string",
            "description": "string",
            "client_key": "string",
            "status": "active",
            "allow_token_read": true,
            "last_used_at": "2019-08-24T14:15:22.123Z"
        },
        "secret": "string"
    }
}

🟠400请求有误

🟠401未认证

修改于 2026-03-16 02:28:54

查询核销汇总报表

查询核销端应用列表