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 Retorna uma lista com os contratos do anunciante.

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": "08/05/2024",
    "expiresAt": "08/06/2024",
    "status": "Active",
    "hasAdsPlan": true,
    "hasWebsitePlan": false
  },
  {
    "id": 1,
    "startsAt": "08/05/2024",
    "expiresAt": "08/06/2024",
    "status": "Active",
    "hasAdsPlan": true,
    "hasWebsitePlan": false
  }
]

text/html

[{"id":1,"startsAt":"08/05/2024","expiresAt":"08/06/2024","status":"Active","hasAdsPlan":true,"hasWebsitePlan":false},{"id":1,"startsAt":"08/05/2024","expiresAt":"08/06/2024","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>08/05/2024</StartsAt>
    <ExpiresAt>08/06/2024</ExpiresAt>
    <Status>Active</Status>
    <HasAdsPlan>true</HasAdsPlan>
    <HasWebsitePlan>false</HasWebsitePlan>
  </ContractResponse>
  <ContractResponse>
    <Id>1</Id>
    <StartsAt>08/05/2024</StartsAt>
    <ExpiresAt>08/06/2024</ExpiresAt>
    <Status>Active</Status>
    <HasAdsPlan>true</HasAdsPlan>
    <HasWebsitePlan>false</HasWebsitePlan>
  </ContractResponse>
</ArrayOfContractResponse>