GET v1/contracts

Retorna os contratos ativos do anunciante.

Requer Autorização

Para realizar a autorização, é necessário enviar as credenciais de autenticação usando o cabeçalho de autorização.
O cabeçalho de autorização é construído como se segue:

  1. O nome de usuário e a senha são combinadas em uma string "usuário:senha"
  2. A seqüência resultante literal é então codificado em Base64
  3. O método de autorização seguido da palavra "Basic" é, então, colocado antes da seqüência codificada.
Por exemplo, se o usuário é 'Aladdin' e a senha é "abra-de-sésamo" então o cabeçalho deve ser:
Authorization: Basic QWxhZGRpbjphYnJhLWRlLXPDqXNhbW8=

Códigos de Resposta

  • OK (200)
  • BadRequest (400)
  • Unauthorized (401)
  • Forbidden (403)
  • NotFound (404)

Informações da Resposta

Descrição do recurso

ContractResponse array Returns a list of the advertiser's contracts.

NomeDescriçãoTipoInformações adicionais
IdCódigo de identificação do Contrato do anuncianteinteger
StartsAtData de início de vigência do contrato (Formato DD/MM/YYYY)string
ExpiresAtData de expiração de vigência do contrato (Formato DD/MM/YYYY)string
StatusSituação atual do contratostring
HasAdsPlanIndica se o contrato possui Plano de anúnciosboolean
HasWebsitePlanIndica se o contrato possui Plano de Website particular (EmEstoque.com.br)boolean

Formatos da Resposta

application/json, text/json

Observações:

  • No formato Json, os nomes dos parâmetros seguem o padrão camelCase, ou seja, sempre são iniciados com letras minúsculas.
[
  {
    "id": 1,
    "startsAt": "21/01/2025",
    "expiresAt": "21/02/2025",
    "status": "Active",
    "hasAdsPlan": true,
    "hasWebsitePlan": false
  },
  {
    "id": 1,
    "startsAt": "21/01/2025",
    "expiresAt": "21/02/2025",
    "status": "Active",
    "hasAdsPlan": true,
    "hasWebsitePlan": false
  }
]

text/html

[{"id":1,"startsAt":"21/01/2025","expiresAt":"21/02/2025","status":"Active","hasAdsPlan":true,"hasWebsitePlan":false},{"id":1,"startsAt":"21/01/2025","expiresAt":"21/02/2025","status":"Active","hasAdsPlan":true,"hasWebsitePlan":false}]

application/xml, text/xml

<ArrayOfContractResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ContractResponse>
    <Id>1</Id>
    <StartsAt>21/01/2025</StartsAt>
    <ExpiresAt>21/02/2025</ExpiresAt>
    <Status>Active</Status>
    <HasAdsPlan>true</HasAdsPlan>
    <HasWebsitePlan>false</HasWebsitePlan>
  </ContractResponse>
  <ContractResponse>
    <Id>1</Id>
    <StartsAt>21/01/2025</StartsAt>
    <ExpiresAt>21/02/2025</ExpiresAt>
    <Status>Active</Status>
    <HasAdsPlan>true</HasAdsPlan>
    <HasWebsitePlan>false</HasWebsitePlan>
  </ContractResponse>
</ArrayOfContractResponse>