API IoT para desenvolvedores — REST, gRPC, tempo real | Kilo

Desenvolvedores

Uma única API IoT para tudo o que você constrói

REST com HTTPS e JSON padrão, gRPC onde contratos tipados importam, streams em tempo real via WebSocket e SSE — tudo autenticado com chaves de API com escopos e idêntico na nuvem e on-premise.

Explorar a referência da API Ler a documentação

api.kiloiot.io

200 OK 
$ curl -sS https://api.kiloiot.io/api/v2/devices \
    -H "X-API-Key: $KILO_API_KEY" \
    -H "X-Organization-Id: $KILO_ORG_ID"

Uma requisição autenticada mínima: dois headers, HTTPS padrão e JSON de volta.

Protocolos

REST primeiro, gRPC quando precisar, streams para dados ao vivo

Dois protocolos e streams em tempo real no mesmo endpoint seguro — escolha a superfície que encaixa na sua integração e mantenha as mesmas chaves com escopos.

O caminho principal

API REST

HTTPS e JSON padrão, usáveis de qualquer cliente HTTP. Leia o estado dos dispositivos e o histórico dos sensores, gerencie dashboards e conexões, trabalhe com as regras e suas versões e despache comandos para dispositivos — tudo o que os escopos da sua chave permitirem.

  • HTTPS + JSON de qualquer linguagem ou ferramenta
  • Dispositivos, sensores, dashboards, regras, comandos
  • Documentada endpoint por endpoint em api.kiloiot.io

O caminho avançado

API gRPC

Uma interface tipada para integração entre serviços: clientes gerados e um contrato estável, com a mesma autenticação por chave de API do REST. Encaixe natural para instalações on-premise que conectam sistemas internos.

  • Clientes tipados e gerados
  • Integração entre serviços e on-premise
  • A mesma autenticação X-API-Key do REST

Sem polling

Streams em tempo real

A telemetria ao vivo fica disponível externamente via WebSocket e Server-Sent Events (SSE) — os mesmos mecanismos usados pelos dashboards da plataforma — para que seus sistemas consumam os dados conforme chegam, sem consultas repetidas.

  • Endpoints WebSocket e SSE
  • Os mesmos streams em que os dashboards rodam
  • Dados conforme chegam — sem ciclos de refresh

Segurança

Chaves de API com escopos, feitas para o mínimo privilégio

Cada requisição — REST ou gRPC — se autentica com uma chave com escopos no header X-API-Key mais a sua organização em X-Organization-Id. As chaves são criadas e gerenciadas em Settings → API Keys.

01

Escopos Read e Write por área

Dispositivos, sensores, dashboards, regras, comandos, conexões e mais: a maioria das áreas separa leitura e escrita, e uma chave concede apenas o que você selecionar ao criá-la.

02

Exibida uma vez, rotacionada em um clique

O valor completo da chave aparece uma única vez na criação; depois só um prefixo curto fica visível. A rotação gera um novo valor e desativa a chave antiga na hora — o único caminho de recuperação para uma chave perdida.

03

Expiração, status e último uso

Defina data de expiração para chaves temporárias ou de terceiros e acompanhe o status de cada chave — Active, Rotated ou Revoked — junto com o timestamp da última chamada.

04

Isolamento por organização

Uma chave pertence à organização onde foi criada, e a organização de cada requisição precisa corresponder: a chave de um cliente nunca alcança os dados de outro.

Settings → API Keys

⚠ Copy this key now. You will not be able to see it again.

Name Scopes Status Last Used

wms-sync-prod

kilo_9f2…
Devices · ReadSensors · Read
Active 2026-07-01 14:32

analytics-pipeline

kilo_c41…
Dashboards · Read
Active 2026-07-01 09:05

ci-deploy-rules

kilo_77a…
Rules · Write
Rotated 2026-06-12 18:20

contractor-audit

kilo_e08…
Logs · Read
Revoked 2026-05-30 11:47

Gerenciado em Settings → API Keys: uma chave por integração, limitada exatamente ao que ela precisa.

Implantação

A mesma API IoT na nuvem e na sua própria infraestrutura

Integrações construídas contra o endpoint na nuvem migram sem mudanças para uma instalação auto-hospedada: uma única superfície de API, onde quer que o servidor rode.

Kilo Cloud

O endpoint gerenciado: crie uma chave em Settings → API Keys e comece a chamar a API — sem infraestrutura própria para operar.

  • Endpoint gerenciado e seguro
  • Comece grátis — sem dados de pagamento
  • Referência completa da API em api.kiloiot.io

Kilo On-Premise

O mesmo servidor, auto-hospedado dentro do seu próprio perímetro de rede — com a mesma API REST e gRPC e as mesmas chaves com escopos: nada muda nas suas integrações.

  • Roda dentro do seu perímetro de rede
  • API idêntica — as integrações portam sem mudanças
  • gRPC como escolha natural para automação interna entre serviços
Fale com a gente sobre on-premise →

Open source

KiloCenter — o service center mioty de código aberto

O KiloCenter é o nosso service center mioty de código aberto, publicado sob a licença AGPL e desenvolvido abertamente no GitHub. Ele opera o lado mioty da sua rede como um produto por si só — feito para desenvolvedores que querem ser donos do próprio stack.

Integre via gRPC e MQTT, implante com Docker ou Kubernetes e conecte-o ao que você roda na sequência.

Ver no GitHub Conhecer o mioty Service Center

Desenvolvedores

FAQ para desenvolvedores

Como autentico as requisições à API?

Cada requisição carrega uma chave de API com escopos no header X-API-Key (formato kilo_<chave>) mais o ID da sua organização em X-Organization-Id. As chaves são criadas em Settings → API Keys e todo o tráfego roda sobre TLS.

Devo usar REST ou gRPC?

Comece com REST: é o caminho principal e funciona de qualquer cliente HTTP. Escolha gRPC quando precisar especificamente de clientes tipados gerados ou de integração entre serviços, tipicamente on-premise. Os dois se autenticam do mesmo jeito.

Consigo dados em tempo real sem polling?

Sim. Streams ao vivo estão disponíveis via WebSocket e Server-Sent Events (SSE) — os mesmos mecanismos que os dashboards da plataforma usam internamente — então seus sistemas recebem os dados conforme chegam.

A API é a mesma numa instalação on-premise?

Sim. Uma instalação on-premise expõe a mesma API dentro do seu próprio perímetro de rede: integrações construídas contra a nuvem migram sem mudanças — e ali o gRPC é o encaixe natural para a automação interna.

Comece a construir sobre a API IoT da Kilo

Crie uma conta grátis, gere uma chave com escopos e faça sua primeira chamada em minutos — ou agende uma conversa para planejar uma implantação on-premise.

Comece grátis Agende uma conversa