Référence API
Logs
Endpoint POST /api/v1/logs and POST /v1/logs
Deux endpoints écrivent dans la même table : le format JSON propre à Blipit et l'endpoint de logs OpenTelemetry. Les deux acceptent l'une ou l'autre clé et sont limités par requête, par minute et par mois.
1Format Blipit
X-Blipit-Key ou Authorization: Bearer, publique ou secrète. Corps : un tableau JSON, un objet unique, ou du NDJSON ; jusqu'à 1 000 lignes et 1 Mo après décompression gzip, deflate ou brotli. Par ligne : message (requis, coupé à 8 Ko ; msg est accepté aussi), level (trace, debug, info, warn, error, fatal ; absent vaut info), timestamp (ISO ou epoch, borné à un jour en arrière et cinq minutes en avant), service, environment, trace_id, attributes (objet plat, jusqu'à 50 valeurs chaîne, nombre ou booléen).
curl https://in.blipit.io/api/v1/logs \
-H "Content-Type: application/json" -H "X-Blipit-Key: <secret key>" \
-d '[{"level":"error","message":"payment declined","service":"api","trace_id":"4bf92f3577b34da6a3ce929d0e0e4736","attributes":{"order_id":42,"gateway":"stripe"}}]'2Réponses
202 {accepted: true, stored, rejected, errors} : les lignes invalides sont ignorées et nommées. 202 {accepted: false, reason: 'log quota reached'} une fois le quota du mois épuisé. 400 quand le corps n'est pas du JSON ou qu'aucune ligne n'est valide. 413 quand le corps ou le nombre de lignes dépasse la limite. 401 clé inconnue.
3OTLP
POST /v1/logs avec les mêmes en-têtes et du JSON OTLP/HTTP (le protobuf reçoit 415). Les attributs de ressource service.name et deployment.environment deviennent service et environment ; les numéros de sévérité sont mappés sur les six niveaux. Répond 200 {} ou {partialSuccess: {rejectedLogRecords, errorMessage}}, y compris quand le quota est atteint.
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://in.blipit.io/v1/logs
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/json
OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-blipit-key=<secret key>Bon à savoir
- Quota par mois en octets stockés : Free 1 Go, Solo 5 Go, Team 20 Go, Scale 100 Go ; rétention 3, 14, 30, 30 jours.
- 300 requêtes par minute et par clé, partagées avec les événements et les spans.
Bloqué ? Écrivez à support@blipit.io. Les clés et le DSN exact de chaque projet sont sous Clés API dans app.blipit.io.

