[IMPORTANTE] Fluxo de API para Atributos com seleção de opções

Olá desenvolvedores,

Para solucionar casos em que valores de Atributos de Item onde há um número muito grande de opções de seleção (attribute_info > input_type = 2), disponibilizamos o endpoint product.search_attribute_value_list que permite a busca de valores ou a exibição de todas as opções disponíveis de forma organizada e paginada em grupos de até 100 opções por página. Os atributos que permitem a busca por esse endpoint possuem o campo attribute_info > support_search_value = true. Para utilizá-lo é necessário enviar como parâmetro de requisição os seguintes campos: attribute_id : Identificador do atributo do qual serão exibidos as opções de seleção - Parâmetro Obrigatório

value_name : Valor de opção do atributo a ser procurado na base, mais de uma palavra pode ser enviada e todas serão consideradas para a busca, podendo retornar vazio em caso de opção não encontrada, recomendamos o uso de poucas palavras para evitar um falso-vazio devido a um espaço de busca muito restrito - Parâmetro Opcional

cursor : Posição inicial das opções a serem exibidas, utilizado para paginação, para a busca inicial o valor 0 deve ser enviado. - Parâmetro Obrigatório

limit : Quantidade máxima de opções a serem exibidas por página, deve ser utilizado um valor entre 1 e 100 - Parâmetro Obrigatório

Para casos em que se deseja buscar todas as opções possíveis, o campo value_name não deve ser enviado na chamada e o valor de cursor deve ser atualizado sucessivamente com o valor utilizado como limit da chamada anterior até que o campo has_next da response tenha o valor false. Exemplo de atributo com suporte a busca pelo endpoint:

Exemplo de chamada para search_attribute_value_list:

curl --location --request POST 'https://openplatform.shopee.com.br/api/v2/product/search_attribute_value_list? partner_id=2031905 \ timestamp=1778107415 \ &access_token=WHdJcGXoWWQ1cii182olp0BS9SEKV4A_S2EIwWMcUCg \ &shop_id=322300222& \sign=9e3f80c28ad926feb603863c3d8a7f7826bffb10435df483 \ &attribute_id=101237 \ &value_name=Motorola \ &cursor=0 \ &limit=100'

Exemplo de resposta para search_attribute_value_list:

Caso haja qualquer dúvida sobre a utilização do endpoint estamos disponíveis para solucioná-las via nossa plataforma de tickets. Atenciosamente,

Equipe Shopee Open API Brasil