Entrar

Atualizar SKUs da Coleção

PUT https://{organization}.myguper.com/api/catalog/collection/{id}/skus/by/{interface}

Substitui o conjunto de SKUs de uma coleção para uma interface específica. O body é uma string com tokens separados por ; (NÃO é JSON). Cada token pode ser:

  • SKU exato: sku-123
  • faixa numérica: inicio:fim (ex: 500:600)
  • padrão LIKE: contém % ou _ (ex: ot%, %ot, %ot%). Patterns são gravados em lowercase e o match é case-insensitive.

Ordem de resolução do token: pattern (%/_) → range (:) → exato. Um token com % é sempre interpretado como pattern, mesmo se também contiver :.

Endpoint "replace all": os SKUs/ranges/patterns existentes do par (coleção, interface) são removidos antes dos novos tokens serem inseridos.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

Send your user token in the x-guper-authorization header.

Cabeçalhos

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Use `text/plain` — o body é uma string crua separada por ponto-e-vírgula, não JSON.

Parâmetros do caminho

Name Type Description
id * integer Id da coleção.
interface * string Interface externa (ex: `ecommerce`, `vtex`) a que os SKUs pertencem.

Corpo da requisição

Content-Type: text/plain

ot%; %ot; sku-exato-1; 500:600

Respostas

{
    "success": true
}
Copied to clipboard