Skip to content

Criar campos de catálogo

post

/catalogs/{catalog_name}/fields

Use esse ponto de extremidade para criar vários campos em seu catálogo.

Pré-requisitos

Para usar esse endpoint, você precisará de uma chave de API com a permissão catalogs.create_fields.

Limite de taxa

This endpoint has a shared rate limit of 50 requests per minute between all asynchronous catalog fields and selections endpoints, as documented in API rate limits.

Parâmetros da jornada

Parâmetro Obrigatória Tipo de dados Descrição
catalog_name Obrigatória String Nome do catálogo.

Parâmetros de solicitação

Parâmetro Obrigatória Tipo de dados Descrição
fields Obrigatória Vetor Um vetor que contém objetos de campo. Os objetos de campos devem conter o nome e o tipo dos novos campos.

Exemplo de solicitação

Resposta

Há três respostas de código de status para esse endpoint: 202, 400 e 404.

Exemplo de resposta bem-sucedida

O código de status 202 poderia retornar o seguinte corpo de resposta.

Exemplo de resposta de erro

O código de status 400 poderia retornar o seguinte corpo de resposta. Consulte Solução de problemas para obter mais informações sobre os erros que você pode encontrar.

Solução de problemas

A tabela a seguir lista os possíveis erros retornados e as etapas de solução de problemas associadas.

Erro Solução de problemas
arbitrary-error Ocorreu um erro arbitrário. Tente novamente ou entre em contato com o suporte.
catalog-not-found Verifique se o nome do catálogo é válido.
company-size-limit-already-reached O limite de tamanho do armazenamento do catálogo foi atingido.
request-includes-too-many-fields Cada solicitação pode suportar até 50 novos campos.
catalog-exceeds-fields-limit O catálogo não pode ter mais de 500 campos.
QUÃO ÚTIL FOI ESTA PÁGINA?
New Stuff!