Requisição de consulta de renovações

A URL usada para fazer a requisição do arquivo JSON é https://apps.eupreciso.com.br/v1.0/integradores/autoupload/renews, método POST. Essa requisição deve conter o access_token de cada anunciante no header como: Authorization: Bearer <access_token>.

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
`reference`	string	Sim	Data de referência (MM/AAAA)
`ads`	object	Sim	Estrutura contendo o ID do anúncio, data de renovação automática.

ADS

Parâmetro	Valores	Obrigatório	Descrição
`id`	string	Não	Identificador do anúncio¹.
`list_id`	string	Não	Identificador do anúncio no Eu Preciso
`date`	string (ISO Datetime)	Sim	Data da renovação
`autoRenew`	boolean	Sim	Indica se o anúncio será renovado automaticamente

1 – Se o campo id não estiver presente, significa que o anúncio foi inserido manualmente pelo usuário na plataforma.

Retorno de erro esperado

Caso ocorra algum erro, a consulta retorna um status code > 200 e um JSON com o motivo e a mensagem do erro.

Códigos e motivos de erros da requisição retornados

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

Exemplo de Retorno

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

[
  {
    "reference": "12/2023",
    "ads": [
      {
        "id": "123456789123",
        "list_id": "656cb3180b8aabb0ffe61856",
        "date": "2023-12-04T01:57:31.806Z",
        "autoRenew": true
      }
    ]
  },
  {
    "reference": "01/2024",
    "ads": [
      {
        "list_id": "648ba28c637bed93add5d359",
        "date": "2024-01-03T03:02:55.159Z",
        "autoRenew": true
      }
    ]
  },
  {
    "reference": "02/2024",
    "ads": [
      {
        "list_id": "656520bb0083e826147be25b",
        "date": "2024-02-25T23:05:33.501Z",
        "autoRenew": false
      },
      {
        "list_id": "65661bc390802a34a04dd46a",
        "date": "2024-02-26T16:56:37.804Z",
        "autoRenew": true
      }
    ]
  },
  {
    "reference": "03/2024",
    "ads": [
      {
        "list_id": "649dd532400912b6d430b724",
        "date": "2024-03-01T22:30:54.221Z",
        "autoRenew": true
      },
      {
        "list_id": "63dc46188a20792c14eca667",
        "date": "2024-03-15T04:57:58.477Z",
        "autoRenew": false
      }
    ]
  }
]

Requisição de consulta de saldo e limite Desabilitação de Renovação Automática