{"id":20431704,"url":"https://github.com/skylinecommunications/slc-udapi-dataapi-proxy","last_synced_at":"2026-01-17T12:50:08.605Z","repository":{"id":236292635,"uuid":"762267871","full_name":"SkylineCommunications/SLC-UDAPI-DataAPI-Proxy","owner":"SkylineCommunications","description":"Forward data from external endpoints into the DataAPI via this User Defined API","archived":false,"fork":false,"pushed_at":"2026-01-15T12:16:50.000Z","size":487,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T16:30:23.223Z","etag":null,"topics":["data-api","data-sources","dataminer-user-defined-api"],"latest_commit_sha":null,"homepage":"https://docs.dataminer.services/user-guide/Advanced_Modules/Data_Sources/Data_Sources.html","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SkylineCommunications.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-23T12:30:04.000Z","updated_at":"2026-01-15T12:14:07.000Z","dependencies_parsed_at":"2024-11-15T08:12:41.895Z","dependency_job_id":"586f1784-d130-4912-a99c-6b18e78f89ff","html_url":"https://github.com/SkylineCommunications/SLC-UDAPI-DataAPI-Proxy","commit_stats":null,"previous_names":["skylinecommunications/slc-udapi-dataapi-proxy"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/SkylineCommunications/SLC-UDAPI-DataAPI-Proxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkylineCommunications%2FSLC-UDAPI-DataAPI-Proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkylineCommunications%2FSLC-UDAPI-DataAPI-Proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkylineCommunications%2FSLC-UDAPI-DataAPI-Proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkylineCommunications%2FSLC-UDAPI-DataAPI-Proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SkylineCommunications","download_url":"https://codeload.github.com/SkylineCommunications/SLC-UDAPI-DataAPI-Proxy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SkylineCommunications%2FSLC-UDAPI-DataAPI-Proxy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28508630,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T11:50:55.898Z","status":"ssl_error","status_checked_at":"2026-01-17T11:50:55.569Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-api","data-sources","dataminer-user-defined-api"],"created_at":"2024-11-15T08:12:39.709Z","updated_at":"2026-01-17T12:50:08.593Z","avatar_url":"https://github.com/SkylineCommunications.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# User-Defined API DataAPI Proxy\n\n## About\n\nThis package contains a [user-defined API](https://aka.dataminer.services/UDA) that functions as a secure reverse proxy to enable external interaction with Data API.\n\nThe [DataMiner Data API](https://aka.dataminer.services/data_api), which is currently still in [soft-launch](https://community.dataminer.services/scripted-connectors-are-here/), offers flexible access to data from any source imaginable, across hardware, software, and cloud services. This data is directly reflected in the element, and can be easily updated using the same API, eliminating the need to develop a connector.\n\nCurrently, the Data API is limited to only accept local requests, most commonly through [scripted connectors](https://aka.dataminer.services/scripted_connectors).\n\n## Setting up the proxy script\n\n### Deploying the user-defined API\n\nDeploy the script onto your cloud-enabled DataMiner System.\n\nSee also: [Managing APIs and tokens in DataMiner Cube](https://aka.dataminer.services/managing_apis_and_tokens_in_cube)\n\n### Configuring the user-defined API\n\n1. Configure the user-defined API to expose the Data API as an external API interface with the endpoints `data/parameters` and `data/config`.\n\n1. Set *Method to be executed* to \"**Raw body**\".\n\n   ![Data API User Defined API Configure](./images/2_UD_API.png)\n\n1. Secure the API with an API token.\n\n   ![Data API User Defined API Overview](./images/1_UD_API.png)\n\n### Using the Data API via the proxy\n\nIn this example, the endpoint `/api/custom/data/parameters` will be used with the HTTP verb **PUT** to send data to DataMiner and automatically create an element.\n\nYou can use any HTTP client to send data to the Data API via the proxy (e.g. [Postman](https://www.postman.com/)).\n\n1. **Add URL-encoded parameters.**\n\n   When pushing data to DataMiner, you need to provide two URL parameters: `identifier` and `type`.\n\n   - `identifier`: A unique identifier (e.g. `DataAPI Test Element 1`). This will be used as the name of the new element.\n   - `type`: The type of the auto-generated connector (e.g. `Skyline DataAPI Test Protocol`).\n\n   \u003e [!TIP]\n   \u003e Each element requires a unique `identifier`, but elements can share a `type`. Elements that share a `type` will share the same parameters and layout, but can still have distinct data.\n\n   \u003e [!IMPORTANT]\n   \u003e When interacting with the Data API directly, `identifier` and `type` should be provided as HTTP headers, not as URL parameters.\n\n1. **Configure JSON in the body.**\n\n   In this example, use the following JSON code:\n\n   ```json\n   {\n     \"Server Name\": \"WebServer001\",\n     \"CPU Utilization\": 78.5\n   }\n   ```\n\n1. **Configure the bearer token**\n\n   In your HTTP client, configure the **bearer token**. In Postman, this token is located on the **Authorization tab**.\n\n   See also [Configuring the user-defined API](#configuring-the-user-defined-api) above.\n\n1. **Send the request**  \n\n   Send the PUT request. The result will indicate whether the operation was successful (*200 OK*) or not. In the latter case, feedback will be provided.\n\n### Result\n\nAfter executing the PUT request, a new element should appear in your DataMiner System. Also, every update you send afterward will instantly be reflected in your new element.\n\nThe element will be associated with an automatically generated *connector*, which will be present in the **Protocols and Templates** module. There, you can configure alarm thresholds and trending to manage the received data.\n\n![Result](./images/2_Result.png)\n\n## Prerequisites\n\n- DataMiner 10.4.2 or higher\n- A cloud-connected DataMiner Agent on which this user-defined API is deployed.\n\n## Documentation\n\nFor more information, see:\n\n- [Data API](https://aka.dataminer.services/data_api)\n- [Scripted connectors](https://aka.dataminer.services/scripted_connectors)\n- [User-Defined APIs](https://aka.dataminer.services/UDA)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskylinecommunications%2Fslc-udapi-dataapi-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskylinecommunications%2Fslc-udapi-dataapi-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskylinecommunications%2Fslc-udapi-dataapi-proxy/lists"}