适用场景 #

目前我们提供了 Golang 以及 Web（包括 node.js）的文案拉取 SDK，对于其他场景，比如 Java 或者 Python 服务端，我们暂时没有提供封装好的 SDK。在此类场景下，可以使用文案拉取 API 进行文案拉取。

API 域名 #

国内：starling-public.zijieapi.com （从国内机房拉取)
海外：starling-public.byteintlapi.com（从海外机房拉取）

使用方式 #

备注：以国内域名为例

第一步 获取鉴权信息 #

接口地址：
https://starling-public.zijieapi.com/v3/get_auth_token/$api_key/$project_id/$namespace_id/

接口方法： POST

参数说明：

api_key、project_id、namespace_id 可以在 starling 控制台获取。

接口响应：

{
	"data": {
		"token": "xxxx" // 鉴权 token，作为第二步的请求头参数
	},
	"status": 200
}

Demo：

curl --location --request POST 'https://starling-public.zijieapi.com/v3/get_auth_token/$api_key/$operator_id/$project_id/$namespace_id/'

第二步 拉取文案 #

接口地址：

接口方法： GET

参数说明：
path 参数

locale 可在控制台配置：

请求头参数

接口响应：

{
    "message": {
        "data": { // 文案信息
            "key1": "value1",
            "key2": "value2"
        },
        "version": 1651916743696499000,
        "release_version": "0.0.3"
    },
    "status": 200
}

Demo：

curl --location --request GET 'https://starling-public.zijieapi.com/text2/$namespace_id/$locale' \\
\--header 'Authorization: $token'