Vendor translations

Get vendor translation

GET read_products + read_translations

Fetch one vendor translation.

Returns stored translated Vendor fields for one locale, including whether the translation is out of date.

Path parameters

Name	Type	Description
`id` required	`integer`	Vendor id. Example: `7`
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for vendors.
404 VENDOR_NOT_FOUND
Vendor does not exist in this store.

curl https://api-store.tringify.com/api/2025-01/vendors/7/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/vendors/7/translations/fr", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_STORE_API_TOKEN" },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/vendors/7/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "fields": {
      "name": {
        "value": "Acme Supplies FR",
        "is_outdated": false,
        "word_count": 3
      }
    }
  }
}

Set vendor translation

PUT write_products + write_translations

Set one vendor translation.

Writes translated Vendor fields for one locale. Empty values clear the matching field translation.

Path parameters

Name	Type	Description
`id` required	`integer`	Vendor id. Example: `7`
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`translations` required	`object`	Field-keyed translation values. Allowed fields come from `contract.translation.fields`. Example: `{"name": "Acme Supplies FR", "description": "Acme Supplies fournit du matériel outdoor en gros."}`

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for vendors.
404 VENDOR_NOT_FOUND
Vendor does not exist in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/vendors/7/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": {
    "description": "Acme Supplies fournit du matériel outdoor en gros.",
    "name": "Acme Supplies FR"
  }
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/vendors/7/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": {
      "description": "Acme Supplies fournit du matériel outdoor en gros.",
      "name": "Acme Supplies FR"
    }
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/vendors/7/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": {
            "description": "Acme Supplies fournit du matériel outdoor en gros.",
            "name": "Acme Supplies FR",
        },
    },
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "resource_type": "vendor",
    "resource_id": "7",
    "locale": "fr"
  }
}

Batch get vendor translations

GET read_products + read_translations

Fetch vendor translations in batch.

Returns translated Vendor fields for multiple vendor ids in one locale.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Query parameters

Name	Type	Description
`ids` required	`string`	Comma-separated vendor ids. Example: `1,2,3`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for vendors.
404 VENDOR_NOT_FOUND
Vendor does not exist in this store.

curl https://api-store.tringify.com/api/2025-01/vendors/translations/fr?ids=1,2,3 \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/vendors/translations/fr?ids=1,2,3", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_STORE_API_TOKEN" },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/vendors/translations/fr?ids=1,2,3",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "resources": {
      "vendor:7": {
        "fields": {
          "name": {
            "value": "Acme Supplies FR",
            "is_outdated": false
          }
        }
      }
    }
  }
}

Batch set vendor translations

PUT write_products + write_translations

Set vendor translations in batch.

Writes translated Vendor fields for multiple vendor ids in one locale. Either every row is written or, if any row is invalid, none are.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`translations` required	`array<object>`	Rows with `id` and `fields`. Allowed field keys come from `contract.translation.fields`. Example: `[{"id": 7, "fields": {"name": "Acme Supplies FR"}}]`

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for vendors.
404 VENDOR_NOT_FOUND
Vendor does not exist in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/vendors/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": [
    {
      "fields": {
        "name": "Acme Supplies FR"
      },
      "id": 7
    }
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/vendors/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": [
      {
        "fields": {
          "name": "Acme Supplies FR"
        },
        "id": 7
      }
    ]
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/vendors/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": [{
            "fields": {
                "name": "Acme Supplies FR",
            },
            "id": 7,
        }],
    },
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "updated": 1
  }
}