INTEGRAÇÕES IWEBIT

Ligue a sua operação à iWebIT.

Uma API segura, apenas de consulta, para integrar os Devices e a Domótica da sua empresa Corporate.

A v1 aceita exclusivamente GET. Não inclui comandos de Domótica, operações do gateway de agentes, sessões de utilizador ou alterações de inventário.

iwebit / developer-apiGET

GET /api/v1/public/devices

Authorization: Bearer iw_live_••••••••

200 OK

{ "data": [ ... ], "meta": { "next_cursor": null } }

GET onlyScoped by companyAuditable usageIP allow lists

API V1

Acesso Corporate

Um administrador cria e revoga chaves em Definições da empresa → API para Desenvolvedores. A chave completa é apresentada apenas uma vez.

Acesso Corporate

Um administrador cria e revoga chaves em Definições da empresa → API para Desenvolvedores. A chave completa é apresentada apenas uma vez.

Consulta, sem comandos

A v1 aceita exclusivamente GET. Não inclui comandos de Domótica, operações do gateway de agentes, sessões de utilizador ou alterações de inventário.

Segurança e privacidade

A chave é guardada apenas como HMAC-SHA-256. Cada chave pode limitar-se por IP ou CIDR. Passwords, usernames, segredos de callback, screenshots, cookies, sessões e dados de controlo são excluídos. Cada chamada autenticada é registada para auditoria e futura faturação, sem guardar pedidos, respostas ou credenciais.

REFERENCE

Endpoints disponíveis

Base URL · https://api.iwebit.app/api/v1/public

GET/devices

Lista de Devices com paginação por cursor.

GET/devices/{deviceId}

Detalhe seguro do DeviceView: inventário, rede, discos, software, atualizações, alertas e ocorrências.

GET/domotics

Lista de equipamentos de Domótica com paginação por cursor.

GET/domotics/{domoticaId}

Detalhe seguro do DomoticaView: canais, sensores, telemetria, histórico e ocorrências.

Autenticação

Exemplo de ligação

cURL

curl --request GET 'https://api.iwebit.app/api/v1/public/devices?per_page=50' --header 'Authorization: Bearer iw_live_<key-id>.<secret>' --header 'Accept: application/json'

Autenticação

Envie a chave no header Authorization e guarde-a num gestor de segredos. Nunca a inclua em URLs, repositórios ou frontend. A sandbox abaixo é uma exceção controlada: envia-a diretamente para a API e mantém-na apenas na memória do browser.

Paginação e limites

As listas aceitam cursor e per_page (1 a 100). Use meta.next_cursor enquanto existir. O limite inicial é de 120 pedidos por minuto por chave; os cabeçalhos X-RateLimit-* indicam o consumo.

Erros

Os erros devolvem error.code, error.message e error.requestId. Guarde o X-Request-Id para apoio. 401 indica chave inválida; 403, licença, IP ou scope sem autorização; 404 protege dados inexistentes ou de outra empresa; 429 indica limite excedido.

SANDBOX INTERATIVA

Teste a sua chave sem a expor.

Experimente uma consulta de leitura com a chave da sua empresa. O pedido segue diretamente do seu browser para a API iWebIT.

A chave não é guardada, não é enviada ao site institucional e é removida quando fecha ou atualiza esta página.

Limite da Sandbox: 10 tentativas por endereço IP em cada período de 24 horas.

Browser → API, sem proxy do website

Pronto para testar. A chave permanece apenas na memória deste browser.

Pedido

GET /devices?per_page=20
Authorization: Bearer ••••••••
Accept: application/json

Resposta

Ainda não existe resposta.