需要 read_translation 权限点。
更多权限点使用信息,请参考:
POST https://{handle}.myshopline.com/admin/openapi/v20250601/ugc/resources.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handleopen001
批量查询店铺的翻译语料。
请求头
  • Content-Type required
    字段值固定为application/json; charset=utf-8
  • Authorization string required
    资源的访问令牌。请参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
请求体
  • locale string
    市场 里面使用的语言。
    例如 en
    Example: en
  • market string
    商店的主要市场。
    Example: 2805652120189036673434
  • outdated boolean
    查询过时或最新的翻译数据。如果原始内容已更新但翻译尚未更新,则翻译将被标记为“过时”。
    • true: 查询过时的翻译数据。
    • false: 查询最新的翻译数据。
    Example: true
  • resource_listobject[] required
    资源对象列表。
  • resource_id string required
    资源的唯一标识符。
    样例:当 resource_typePRODUCT 时,该参数值为商品 ID。
    Example: 1636453548928
  • resource_type string required
    资源的类型。
    样例:PRODUCT
    Example: PRODUCT
响应
更多状态码信息请参考 HTTP 状态码

响应头
  • traceId
    traceId
响应体
  • dataobject
    响应结果。
  • resource_listobject[]
    资源对象列表。
  • content_listobject[]
    资源对应的翻译语料列表。
  • locale string
    市场 里面使用的语言。
    例如 en
    Example: en
  • market string
    商店的主要市场。
    Example: 2805652120189036673434
  • outdated boolean
    查询过时或最新的翻译数据。如果原始内容已更新但翻译尚未更新,则翻译将被标记为“过时”。
    • true: 查询过时的翻译数据。
    • false: 查询最新的翻译数据。
  • resource_content string
    资源对应的翻译语料内容。
  • resource_content_type string
    resource_content 返回的内容的数据类型。例如,如果 resource_content 返回产品标题 多色拼接连衣裙,则 resource_content_type 返回 STRING
    Example: STRING
  • resource_field string
    resource_content 的内容关联的属性。例如,如果 resource_content 返回产品标题,则 resource_field 返回 title
    Example: title
  • updated_at string
    语料更新时间。
    Example: 2023-09-07T15:50:00Z
  • default_content_listobject[]
    原始的未被翻译的语料内容列表。
  • resource_content string
    资源对应的原始语料的文案。
    Example: Title content
  • resource_content_type string
    resource_content 返回的内容的数据类型。例如,如果 resource_content 返回产品标题 多色拼接连衣裙,则 resource_content_type 返回 STRING
    Example: STRING
  • resource_field string
    resource_content 的内容关联的属性。例如,如果 resource_content 返回产品标题,则 resource_field 返回 title
    Example: title
  • resource_id string
    资源对象的标识符。
    样例:当 resource_typePRODUCT,代表商品 ID。
    Example: 1636453548928
  • resource_type string
    资源的类型。
    样例:PRODUCT
    Example: PRODUCT
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

header required

Body

required
{
  "locale": "en",
  "market": "2805652120189036673434",
  "outdated": true,
  "resource_list": [
    {
      "resource_id": "1636453548928",
      "resource_type": "PRODUCT"
    }
  ]
}

Language

curl --request POST \
--url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/ugc/resources.json \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'accept: application/json' \
--data '
{
"locale": "en",
"market": "2805652120189036673434",
"outdated": true,
"resource_list": [
{
"resource_id": "1636453548928",
"resource_type": "PRODUCT"
}
]
}
'
Examples
批量查询店铺的翻译语料。
Request
{
"resource_list": [
{
"resource_id": "16065430418665688337653510",
"resource_type": "PRODUCT"
}
]
}
Response
{
"data": {
"resource_list": [
{
"content_list": [],
"default_content_list": [
{
"resource_content": "content",
"resource_content_type": "STRING",
"resource_field": "title"
},
{
"resource_content": "content",
"resource_content_type": "STRING",
"resource_field": "subtitle"
},
{
"resource_content": "<p class=\"indIKd GW0XC cS4Vcb-pGL6qe-fwJd0c\">content</p>",
"resource_content_type": "HTML",
"resource_field": "body_html"
},
{
"resource_content": "content",
"resource_content_type": "STRING",
"resource_field": "meta_title"
},
{
"resource_content": "content",
"resource_content_type": "STRING",
"resource_field": "meta_description"
}
],
"resource_id": "16065430418665688337653510",
"resource_type": "PRODUCT"
}
]
}
}

Error loading component.

Error loading component.