Pular para o conteúdo principal

Atualizar Preço do Anúncio

Atualize o preço de um anúncio específico.

Endpoint​

POST /inventory/price/{ad_id}/update/

Método​

POST

Parâmetros de URL​

ParâmetroTipoDescrição
ad_idintegerID do anúncio

Autenticação​

Este endpoint requer autenticação via JWT. Inclua o token no header:

Authorization: Bearer {access_token}

Requisição​

Body​

{
  "price": 85000
}

Campos Obrigatórios​

CampoTipoDescrição
priceintegerNovo preço do veículo (deve ser maior que 0)

Exemplo de Resposta​

Sucesso​

Status Code: 200 OK

{
  "message": "Preço atualizado com sucesso"
}

Estrutura de Dados​

A resposta é um objeto simples com uma mensagem de confirmação:

CampoTipoDescrição
messagestringMensagem de confirmação da atualização

Exemplo de Uso​

Requisição Completa​

curl -X POST \
  https://api.exemplo.com/v3/inventory/price/12345/update/ \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "price": 85000
  }'

Resposta​

{
  "message": "Preço atualizado com sucesso"
}

Observações​

  • Apenas o método POST é permitido para este endpoint
  • O usuário deve ter permissão para atualizar o anúncio específico (o anúncio deve pertencer a uma loja à qual o usuário tem acesso)
  • Ao atualizar o preço, o sistema automaticamente:
    • Atualiza o preço no cadastro do anúncio
    • Sincroniza o preço com os portais de integração ativos
    • Atualiza o cache do anúncio
    • Registra a alteração para monitoramento de replicação
  • O campo price deve ser um número inteiro positivo
  • O preço é atualizado em todos os portais onde o anúncio está integrado e ativo

Possíveis Retornos de Erro​

400 Bad Request​

Retornado quando o campo price não é fornecido ou está vazio.

"Value for field price is required"

401 Unauthorized​

Retornado quando o token de autenticação não foi fornecido ou é inválido.

{
  "detail": "As credenciais de autenticação não foram fornecidas."
}

ou

{
  "detail": "Token inválido ou expirado."
}

403 Forbidden​

Retornado quando o usuário autenticado não tem permissão para atualizar o anúncio especificado (o anúncio não pertence a uma loja à qual o usuário tem acesso).

{
  "detail": "Você não tem permissão para executar essa ação."
}

404 Not Found​

Retornado quando o anúncio especificado não é encontrado.

{
  "detail": "Não encontrado."
}

405 Method Not Allowed​

Retornado quando um método HTTP diferente de POST é utilizado.

{
  "detail": "Método \"GET\" não permitido."
}