Consultar dados da plataforma

As consultas da aplicação passam pelo Gateway e respeitam o JWT do usuário. Dados de sensores e mercado são filtrados por permissão, enquanto eventos indexados são expostos como leitura autenticada.

Sensores

Rota	O que devolve
`GET /sensors`	Sensores visíveis ao usuário
`GET /sensors/{sensor_id}`	Detalhes de um sensor autorizado
`GET /sensors/{sensor_id}/measurements`	Histórico de medições daquele sensor

Usuários com papel de administrador de sistema veem todos os sensores. Os demais veem apenas sensores em que têm vínculo sensor_admin.

Mercado

Rota	O que devolve
`GET /offers`	Ofertas dos sensores permitidos
`GET /orders`	Ordens dos sensores permitidos
`GET /trades`	Trades em que sensores permitidos participaram

As três rotas aceitam filtro opcional:

?status=OPEN

Status úteis:

ofertas: OPEN, RESERVED, SOLD, CANCELLED;
ordens: OPEN, FILLED, CANCELLED, FAILED;
trades: PENDING_PAYMENT, PAID, ERROR.

Eventos indexados

Rota	O que devolve
`GET /events`	Eventos on-chain indexados
`GET /transactions/{tx_hash}/events`	Eventos de uma transação específica

Filtros disponíveis em /events:

contract_name
event_name
limit

O Indexer usa 100 eventos como padrão e limita a 500. Eventos indexados hoje:

Contrato	Evento
`EuroToken`	`EuroMinted`
`SensorRegistry`	`SensorRegistered`
`EnergyMarket`	`EnergyOfferCreated`
`EnergyMarket`	`EnergyOfferPurchased`
`EnergySettlement`	`SettlementCreated`

Os contratos também declaram SensorStatusChanged e EnergyOfferCancelled. Esses eventos ainda não estão na lista fixa indexada pelo Indexer atual.

Depósitos

Rota	O que devolve
`GET /wallet/bridge-info`	Instruções de depósito e rede privada
`GET /wallet/deposit-requests`	Pedidos de depósito do usuário autenticado

Pedidos de depósito pertencem ao usuário autenticado. O Gateway não lista depósitos de outros usuários.

Perfil

Rota	O que devolve
`GET /me`	Identidade extraída do JWT
`GET /auth/me`	Mesmo perfil sob o grupo de autenticação
`GET /admin-only`	Verificação de acesso administrativo

Quando a API nega acesso

Código	Causa comum
`SENSOR_FORBIDDEN`	Usuário não é admin daquele sensor
`SENSOR_NOT_FOUND`	Sensor inexistente ou não resolvido
`INDEXER_UNAVAILABLE`	Gateway não conseguiu chamar o Indexer
`MARKET_UNAVAILABLE`	Gateway não conseguiu chamar o Market
`ORACLE_UNAVAILABLE`	Gateway não conseguiu chamar o Oracle

Referência técnica

Status, eventos, erros e endpoints em uma visão única

BrightCity Chain

Contratos

Plataforma energética

Consultar dados da plataforma

Sensores

Mercado

Eventos indexados

Depósitos

Perfil

Quando a API nega acesso

Referência técnica

​Sensores

​Mercado

​Eventos indexados

​Depósitos

​Perfil

​Quando a API nega acesso

Referência técnica

Sensores

Mercado

Eventos indexados

Depósitos

Perfil

Quando a API nega acesso