Experiências (Experiences)

Gerencie e consulte o catálogo de passeios, tours e atividades turísticas.

Listar Experiências

GET /api/v1/experiences

Retorna a lista de experiências cadastradas pela sua equipe.

Query Parameters

Parâmetro	Tipo	Descrição
`page`	number	Número da página (padrão: 1)
`limit`	number	Itens por página (padrão: 20, máx: 100)
`search`	string	Buscar por nome ou descrição
`category`	string	Filtrar por categoria
`is_active`	string	Filtrar por status: `true` ou `false`

Exemplo de Requisição

curl -X GET "https://app.moblix.co/api/v1/experiences?search=helicoptero&limit=10" \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui"

const response = await fetch(
  'https://app.moblix.co/api/v1/experiences?search=helicoptero&limit=10',
  {
    headers: {
      'Authorization': 'Bearer mbx_live_sua_chave_aqui'
    }
  }
);

const data = await response.json();
console.log(data.experiences);

import requests

response = requests.get(
    'https://app.moblix.co/api/v1/experiences',
    headers={
        'Authorization': 'Bearer mbx_live_sua_chave_aqui'
    },
    params={
        'search': 'helicoptero',
        'limit': 10
    }
)

data = response.json()
print(data['experiences'])

Resposta

{
  "data": {
    "experiences": [
      {
        "id": "uuid-da-experiencia",
        "name": "Passeio de Helicóptero pelo Rio",
        "slug": "passeio-de-helicoptero-pelo-rio",
        "description": "Voo panorâmico de 15 minutos sobre os principais pontos turísticos do Rio de Janeiro.",
        "short_description": "Voo panorâmico de 15 min sobre o Rio",
        "category": "adventure",
        "duration": 15,
        "duration_unit": "minutes",
        "location": "Heliporto Lagoa",
        "city": "Rio de Janeiro",
        "state": "RJ",
        "country": "BR",
        "price": 890.00,
        "currency": "BRL",
        "max_participants": 4,
        "min_participants": 1,
        "is_active": true,
        "images": [
          {
            "id": "uuid-da-imagem",
            "url": "https://images.example.com/experience/heli-rio.jpg",
            "alt": "Vista aérea do Cristo Redentor",
            "order": 0
          }
        ],
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-15T10:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 45,
      "totalPages": 5,
      "hasNext": true,
      "hasPrev": false
    }
  },
  "timestamp": "2026-01-26T10:30:00Z"
}

Buscar Experiência por ID

GET /api/v1/experiences/:id

Retorna os detalhes completos de uma experiência específica, incluindo campos adicionais como endereço, coordenadas, o que está incluído/excluído e política de cancelamento.

Exemplo de Requisição

curl -X GET https://app.moblix.co/api/v1/experiences/uuid-da-experiencia \
  -H "Authorization: Bearer mbx_live_sua_chave_aqui"

Resposta

{
  "data": {
    "id": "uuid-da-experiencia",
    "name": "Passeio de Helicóptero pelo Rio",
    "slug": "passeio-de-helicoptero-pelo-rio",
    "description": "Voo panorâmico de 15 minutos sobre os principais pontos turísticos do Rio de Janeiro, incluindo Cristo Redentor, Pão de Açúcar e praias.",
    "short_description": "Voo panorâmico de 15 min sobre o Rio",
    "category": "adventure",
    "duration": 15,
    "duration_unit": "minutes",
    "location": "Heliporto Lagoa",
    "address": "Av. Borges de Medeiros, s/n - Lagoa",
    "city": "Rio de Janeiro",
    "state": "RJ",
    "country": "BR",
    "latitude": -22.9714,
    "longitude": -43.2127,
    "price": 890.00,
    "currency": "BRL",
    "max_participants": 4,
    "min_participants": 1,
    "min_age": 3,
    "included": ["Voo de helicóptero", "Seguro", "Fotos durante o voo"],
    "not_included": ["Transfer hotel", "Refeições"],
    "requirements": ["Documento com foto", "Peso máximo 120kg por pessoa"],
    "cancellation_policy": "Cancelamento gratuito até 24h antes",
    "is_active": true,
    "images": [
      {
        "id": "uuid-da-imagem",
        "url": "https://images.example.com/experience/heli-rio.jpg",
        "alt": "Vista aérea do Cristo Redentor",
        "order": 0
      }
    ],
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-15T10:00:00Z"
  },
  "timestamp": "2026-01-26T10:30:00Z"
}

Estrutura da Experiência

Campos da Listagem

Campo	Tipo	Descrição
`id`	string	ID único (UUID)
`name`	string	Nome da experiência
`slug`	string	Slug para URLs
`description`	string	Descrição completa
`short_description`	string	Descrição resumida
`category`	string	Categoria
`duration`	number	Duração numérica
`duration_unit`	string	Unidade: `minutes`, `hours`, `days`
`location`	string	Local/ponto de encontro
`city`	string	Cidade
`state`	string	Estado
`country`	string	País (código ISO)
`price`	number	Preço base
`currency`	string	Moeda (BRL)
`max_participants`	number	Máximo de participantes
`min_participants`	number	Mínimo de participantes
`is_active`	boolean	Se está disponível para venda
`images`	Image[]	Fotos da experiência

Campos Adicionais (GET por ID)

Campo	Tipo	Descrição
`address`	string	Endereço completo
`latitude`	number	Latitude
`longitude`	number	Longitude
`min_age`	number	Idade mínima
`included`	string[]	O que está incluído
`not_included`	string[]	O que não está incluído
`requirements`	string[]	Requisitos para participar
`cancellation_policy`	string	Política de cancelamento

Image

Campo	Tipo	Descrição
`id`	string	ID da imagem
`url`	string	URL da imagem
`alt`	string	Texto alternativo
`order`	number	Ordem de exibição

Categorias de Experiências

Código	Descrição
`tour`	Tours e city tours
`adventure`	Aventura e esportes radicais
`cultural`	Cultural e histórico
`gastronomy`	Gastronomia
`nature`	Natureza e ecoturismo
`transfer`	Transfers e traslados
`cruise`	Passeios de barco
`show`	Shows e espetáculos

Notas Importantes

As experiências são cadastradas pela sua equipe no painel da Moblix. A API permite consultar o catálogo e usar os dados para criar reservas via API de Reservas.

O campo price é o preço base. Para experiências com preços diferenciados por tipo de participante ou duração, consulte os detalhes via GET por ID.

Experiências

On this page