Skip to content

Create telemetryharbor.yaml#111

Open
Adrelien wants to merge 1 commit into
TheThingsNetwork:masterfrom
Adrelien:master
Open

Create telemetryharbor.yaml#111
Adrelien wants to merge 1 commit into
TheThingsNetwork:masterfrom
Adrelien:master

Conversation

@Adrelien

Copy link
Copy Markdown

Summary

Add Telemetry Harbor webhook template to enable seamless integration between The Things Network and Telemetry Harbor IoT platform for LoRaWAN device data ingestion.

Changes

  • Added telemetryharbor.yaml webhook template file
  • Template supports uplink message forwarding to Telemetry Harbor API endpoints
  • Configured X-API-Key header authentication
  • Added user-configurable fields for endpoint URL and API key
  • Optimized field mask for flat JSON numeric data format (temperature, humidity, battery, etc.)
  • Included service description, logo, and documentation URLs

Notes for Reviewers

Implementation Details:

  • The base URL field (harbor-endpoint) expects the complete endpoint URL including the harbor ID and /ttn path, as Telemetry Harbor uses dynamic per-project endpoints (e.g., https://telemetryharbor.com/api/v2/{harbor-id}/ttn)
  • Only uplink-message path is enabled as Telemetry Harbor currently focuses on uplink data ingestion for time-series analytics
  • The template uses an empty path ('') for uplink messages since the complete endpoint is provided in the base URL
  • Field mask is optimized for decoded payload and essential metadata to support Telemetry Harbor's flat JSON structure

Testing:
Please verify that:

  • Logo URL renders correctly from GitHub raw content
  • Documentation URL is accessible
  • The X-API-Key header format is correct

Checklist

  • Scope: The referenced issue is addressed, there are no unrelated changes.
  • Compatibility: The changes are backwards compatible, they don't break existing deployments.
  • Testing: The changes are tested with Telemetry Harbor platform.
  • Documentation: Documentation URL points to Telemetry Harbor's TTN integration guide.

@CLAassistant

CLAassistant commented Dec 10, 2025

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@github-actions github-actions Bot added the needs/triage We still need to triage this label Dec 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs/triage We still need to triage this

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants