Desabilitação de Renovação Automática
Em regra, os anúncios são criados com a renovação automática ativada.
Para desabilitar a renovação automática de um anúncio, o integrador deve fazer uma requisição para a URL https://apps.eupreciso.com.br/v1.0/integradores/autoupload/renews/disable, método POST. Essa requisição deve conter o access_token de cada anunciante no header como: Authorization: Bearer <access_token>.
Corpo da Requisição
ad_ids (Obrigatório): Um campo que deve estar presente no corpo da requisição, contendo um array de strings. Cada string representa um identificador único de um anúncio (ad). O id a ser informado é aquele identificador do vendedor e não o identificador do Eu Preciso. O formato esperado é um array JSON de strings, conforme o exemplo abaixo:
{
"ad_ids": ["123456789123", "456789123", "9874561", "222222222"]
}- Tipo:
array de strings - Formato: Cada elemento do array deve ser uma string representando um identificador de anúncio.
Regras de Validação
- O parâmetro
ad_idsdeve ser um array contendo apenas strings. - Cada valor de ID no array deve ser uma string válida, representando o identificador único de um anúncio.
Retorno de sucesso esperado
A consulta deve retornar um status code 200 e um JSON no corpo da resposta com a estrutura:
| Parâmetro | Valores | Obrigatório | Descrição |
|---|---|---|---|
status | string | Sim | Renovação automática desativada para os anúncios |
ids | array | Sim | Lista de identificadores dos anúncios que tiveram a renovação automática desativada |
Exemplo de Retorno
Requisição: https://apps.eupreciso.com.br/v1.0/integradores/autoupload/renews/disable
{
"status": "Renovação automática desativada para os anúncios",
"ids": ["123456789123", "456789123", "9874561", "222222222"]
}Retorno de erro esperado
Caso ocorra algum erro ou o anunciante não possua os Recursos PRO ativo, a consulta retorna um status code > 400 e um JSON com o motivo e a mensagem do erro.
| Status Code | Descrição | Motivo | Mensagem |
|---|---|---|---|
| 400 | Falta campo de authorization no header da requisição | BAD_REQUEST | Check the header field(s) |
| 401 | Token inválido | ACCESS_DENIED | Check the client authentication token |
| 429 | Rate Limit configurado quando o cliente fizer mais requisições por segundo do que deveria | RATE_LIMIT | You have exceeded the X requests in X seconds limit! |
| 500 | Erro interno inesperado | UNEXPECTED_INTERNAL_ERROR | Unexpected internal error. Try again later |