Habilitação de Renovação Automática

Para habilitar 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/enable, 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_ids deve 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âmetroValoresObrigatórioDescrição
statusstringSimRenovação automática ativada para os anúncios
idsarraySimLista de identificadores dos anúncios que tiveram a renovação automática ativada

Exemplo de Retorno

Requisição: https://apps.eupreciso.com.br/v1.0/integradores/autoupload/renews/enable

{
  "status": "Renovação automática ativada 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 CodeDescriçãoMotivoMensagem
400Falta campo de authorization no header da requisiçãoBAD_REQUESTCheck the header field(s)
401Token inválidoACCESS_DENIEDCheck the client authentication token
429Rate Limit configurado quando o cliente fizer mais requisições por segundo do que deveriaRATE_LIMITYou have exceeded the X requests in X seconds limit!
500Erro interno inesperadoUNEXPECTED_INTERNAL_ERRORUnexpected internal error. Try again later