Estrutura JSON da Resposta

A resposta da API segue a seguinte estrutura hierárquica:

json 
{
  "Operator": [
    {
      "Operator_Code": "string",
      "Operator_Name": "string",
      "Operator_Logo": "string (URL)",
      "Sales": [
        {
          "Number": "string",
          "Code": "string",
          "ValidiyFrom": "string (YYYY-MM-DD)",
          "ValidityUntil": "string (YYYY-MM-DD)",
          "Title": "string",
          "Destination": "string",
          "Nights": "string",
          "Image": "string (URL)",
          "Currency_Symbol": "string",
          "FareDBL": "string",
          "Code_TMP": "string"
        }
      ]
    }
  ]
}

Objeto Operador

Contém as informações básicas do operador de viagens.

Campo Tipo Descrição Exemplo
Operator_Code String Código único de identificação do operador 505
Operator_Name String Nome comercial do operador Operadora XYZ
Operator_Logo String (URL) URL para o logotipo do operador https://www.chipweb-voyage.com.br/simbolo/505.gif
Sales Array Lista de pacotes de viagem disponíveis [...]

Objeto Pacote (Sales)

Representa um pacote de viagem individual disponível para venda.

Campo Tipo Descrição Exemplo
Number String Número de identificação único do pacote 44950
Code String Código completo do pacote para referência 4.10.022.0063.25
ValidiyFrom String (YYYY-MM-DD) Data de início da validade do pacote 2025-01-01
ValidityUntil String (YYYY-MM-DD) Data de fim da validade do pacote 2026-10-31
Title String Título descritivo do pacote Extensão Tailândia - Krabi
Destination String Destino principal do pacote Tailândia
Nights String Número de noites incluídas no pacote 3
Image String (URL) URL para imagem representativa do pacote https://www.chipweb-voyage.com.br/.../44950_2_1.jpg
Currency_Symbol String Símbolo da moeda do preço U$ ou €
FareDBL String Preço por pessoa em acomodação dupla 230.00
Code_TMP String Código temporário ou secundário do pacote 4.10.022.0063.25

Tipos de Dados

Descrição dos tipos de dados utilizados na API:

String

Texto simples. Alguns campos podem conter caracteres especiais (acentos, cedilhas) que devem ser processados com codificação UTF-8.

Exemplo: "Extensão Tailândia - Krabi"

Data (YYYY-MM-DD)

Formato padrão ISO 8601 para datas. Sempre em UTC.

Exemplo: "2025-01-01"

Número (String)

Valores numéricos retornados como strings. Devem ser convertidos para float/decimal para operações matemáticas.

Exemplo: "230.00" → 230.00 (float)

URL

Endereços web completos para recursos externos (imagens, logos).

Exemplo: "https://www.chipweb-voyage.com.br/simbolo/505.gif"

Array

Coleção de objetos do mesmo tipo. No caso da API, o array Sales contém múltiplos pacotes.

Exemplo: [{...}, {...}, {...}]

Códigos de Status HTTP

A API utiliza códigos HTTP padrão para indicar o resultado de uma requisição:

Código Status Descrição
200 OK Requisição bem-sucedida. Dados retornados normalmente.
400 Bad Request Requisição inválida. Verifique os parâmetros enviados.
401 Unauthorized Autenticação falhou. Verifique sua chave de API.
404 Not Found Recurso não encontrado. O operador solicitado não existe.
429 Too Many Requests Limite de requisições excedido. Aguarde antes de tentar novamente.
500 Internal Server Error Erro interno do servidor. Tente novamente mais tarde.

Limites e Quotas

A API possui os seguintes limites para garantir estabilidade e fair use:

Taxa de Requisições

Limite: 1.000 requisições por hora

Descrição: Máximo de chamadas à API permitidas em um período de 1 hora.

Tamanho da Resposta

Limite: Até 5 MB por resposta

Descrição: Tamanho máximo dos dados retornados em uma única requisição.

Timeout

Limite: 30 segundos

Descrição: Tempo máximo de espera pela resposta da API.

Retenção de Dados

Limite: 90 dias

Descrição: Período de retenção de logs de requisições para fins de auditoria.