Biogeneses · Integrações

API REST de temperatura v1

Ingestão segura por equipamento, com Bearer token, JSON e idempotência. O token é criado na Central de conformidade e exibido uma única vez.

POST /api/v1/temperature.php

curl -X POST https://www.biogeneses.com.br/api/v1/temperature.php \
  -H "Authorization: Bearer bgt_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: equipamento-001-20260801T120000Z" \
  -d '{
    "device": "001ABC123456",
    "temperature": 4.72,
    "recorded_at": "2026-08-01T12:00:00-03:00"
  }'

A data usa ISO 8601. O identificador de idempotência deve ter de 8 a 120 caracteres e ser único para cada leitura.

Respostas

HTTP	Significado
201	Leitura criada.
200	A mesma chave já foi processada; resposta idempotente.
401	Token ausente, inválido, expirado ou revogado.
403	O token pertence a outro equipamento.
409	Equipamento inativo.
422	Payload ou data de leitura inválidos.

O endpoint legado temperatura.php?code=... continua disponível para firmwares em campo. Novos projetos devem usar a API v1 para não expor segredos na URL.

Voltar à Central de conformidade