{"id":31103693,"url":"https://github.com/oracle-samples/oci-iot-samples","last_synced_at":"2025-09-17T02:50:10.632Z","repository":{"id":310696862,"uuid":"1033110891","full_name":"oracle-samples/oci-iot-samples","owner":"oracle-samples","description":"Sample scripts and programs to interact with the OCI IoT Platform","archived":false,"fork":false,"pushed_at":"2025-09-12T12:54:26.000Z","size":126,"stargazers_count":1,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-12T15:00:04.453Z","etag":null,"topics":["iot","iot-platform","oci","oracle","oracle-cloud"],"latest_commit_sha":null,"homepage":"","language":"PLSQL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle-samples.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-06T10:09:12.000Z","updated_at":"2025-09-12T12:54:30.000Z","dependencies_parsed_at":"2025-08-19T18:41:04.837Z","dependency_job_id":"87d1adc5-ee48-4599-bdb5-4d0b7937f183","html_url":"https://github.com/oracle-samples/oci-iot-samples","commit_stats":null,"previous_names":["oracle-samples/oci-iot-samples"],"tags_count":0,"template":false,"template_full_name":"oracle/template-repo","purl":"pkg:github/oracle-samples/oci-iot-samples","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Foci-iot-samples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Foci-iot-samples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Foci-iot-samples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Foci-iot-samples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle-samples","download_url":"https://codeload.github.com/oracle-samples/oci-iot-samples/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Foci-iot-samples/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275526358,"owners_count":25480460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-17T02:00:09.119Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["iot","iot-platform","oci","oracle","oracle-cloud"],"created_at":"2025-09-17T02:50:08.554Z","updated_at":"2025-09-17T02:50:10.620Z","avatar_url":"https://github.com/oracle-samples.png","language":"PLSQL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Oracle Internet of Things Platform Samples\n\nThis repository provides examples demonstrating how to use the Oracle Internet of Things\nPlatform.\n\n## Setup\n\nThe examples and tutorials in this repository assume you have already provisioned an IoT\nDomain Group and an IoT Domain. The [IoT from scratch](./samples/script/iot-from-scratch/README.md)\nexample can be used to setup a complete environment from the command line.\n\n## Sending Messages to the OCI IoT Platform Using a GUI\n\nThe samples below show you how to send messages from the command line or using programming\nlanguages.  \nIf you want to send test messages using a GUI, you can use any MQTT-compliant client,\nsuch as the following (Oracle has no preference or affiliation with any of these products):\n\n- [MQTT Explorer](https://mqtt-explorer.com/)\n- [MQTTX](https://mqttx.app/)\n- ...\n\n**Note:** The OCI IoT Platform is _not_ an MQTT broker; you will not be able to listen\nfor messages from your devices.\n\nSimilarly, to test the REST APIs (for example, sending telemetry or querying telemetry\nvia ORDS endpoints), you can use:\n\n- [Insomnia](https://insomnia.rest/)\n- [Postman](https://www.postman.com/)\n- ...\n\n## Viewing Telemetry\n\nThere are several options to view telemetry:\n\n- The APEX IoT Platform Explorer (see below): this is the easiest way to get an\n  overview of your telemetry data.\n- The APEX SQL Workshop to browse the database.\n- Connect directly to the database with\n  [SQLcl](https://www.oracle.com/database/sqldeveloper/technologies/sqlcl/) or\n  [SQL Developer](https://www.oracle.com/database/sqldeveloper/) (see below).\n- Query the database using the ORDS endpoints (see below).\n\n## IoT Platform Explorer\n\nSample [APEX application](./apex/dashboard) that allows you to browse your IoT devices\nas well as the messages received.\n\n## How To\n\n| Description                                          | Command Line          | Python       |\n|------------------------------------------------------|:---------------------:|:------------:|\n| IoT from scratch (Setup IoT environment from command line) | [Sample](./samples/script/iot-from-scratch/) |              |\n| Manage Digital Twins (Create, delete, ...)           | [Sample](./samples/script/manage-dt/) |              |\n| Publish telemetry (HTTPS - REST API)                 | [Sample](./samples/script/publish-https/) | [Sample](./samples/python/publish-https/)  |\n| Publish telemetry (MQTTS - Secure MQTT)              |                       | [Sample](./samples/python/publish-mqtt/)  |\n| Publish telemetry (WSS - Secure MQTT over WebSocket) |                       | [Sample](./samples/python/publish-websockets/)  |\n| Raw command-response scenario                        |                       | [Sample](./samples/python/command-response/)  |\n| Direct database connection — query telemetry         | [Sample](./samples/script/query-db/) | [Sample](./samples/python/query-db/)  |\n\n## Documentation\n\nYou can find the online documentation for the Oracle Internet of Things Platform at\n[docs.cloud.oracle.com](https://docs.cloud.oracle.com/).\n\n## Contributing\n\nSee [CONTRIBUTING](./CONTRIBUTING.md).\n\n## Security\n\nPlease consult the [security guide](./SECURITY.md) for our responsible security\nvulnerability disclosure process.\n\n## License\n\nSee [LICENSE](./LICENSE.txt).\n\n## Disclaimer\n\nOracle and its affiliates do not provide any warranty whatsoever, express or implied, for\nany software, material or content of any kind contained or produced within this\nrepository, and in particular specifically disclaim any and all implied warranties of\ntitle, non-infringement, merchantability, and fitness for a particular purpose.\nFurthermore, Oracle and its affiliates do not represent that any customary security\nreview has been performed with respect to any software, material or content contained or\nproduced within this repository. In addition, and without limiting the foregoing,\nthird parties may have posted software, material or content to this repository\nwithout any review. Use at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-samples%2Foci-iot-samples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle-samples%2Foci-iot-samples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-samples%2Foci-iot-samples/lists"}