HoolIt is an open-source project aiming to provide a simple and easy-to-use alternative to the beloved dweet.io, which sadly is no longer available. If you were a fan of dweet.io's simplicity for quickly sending and receiving data from your "things," HoolIt is designed for you!

It uses the exact same API scheme as dweet.io, making migration and understanding incredibly straightforward. No signup, no setup, it just works (once you have HoolIt running, of course!).

Feature Status

✅ Dweeting (Sending Data):
✅ Real-time Streams (Listening):
✅ dweet.io API Compatibility (Core):
✅ HTTP & HTTPS Support:
✅ Query Parameters for Dweets:
❌ JSONP Support:
❌ Dweet History (Getting Dweets):

HoolIt API Documentation (dweet.io Compatible)

Dweeting (Sending Data)

Send data from your thing to the cloud by "dweeting" it with a simple HAPI web API, just like you did with dweet.io.

To dweet from your thing, simply call a URL like:

https://[YOUR_HOOLIT_HOST]/create/with/{your-thing-name}?your_key=your_value&another_key=another_value

Replace:

[YOUR_HOOLIT_HOST] with the actual hostname or IP address where your HoolIt instance is running.
{your-thing-name} with a unique name for your "thing." This is how you will identify your data streams.
your_key=your_value&another_key=another_value with any query parameters you want to include in your dweet.

Example:

To send data for a thing named my-sensor with temperature and humidity values:

https://[YOUR_HOOLIT_HOST]/create/with/my-sensor?temperature=25&humidity=60

Any query parameters you add to the request will be added as key-value pairs to the content of the dweet.

Response:

HoolIt will respond with a JSON object in the following format upon successful dweeting:

{
  "this": "succeeded",
  "by": "dweeting",
  "the": "dweet",
  "with": {
    "thing": "{your-thing-name}",
    "created": "2024-XX-XXTXX:XX:XX.XXXZ", // Date and time of dweet creation in UTC
    "content": {
      "your_key": "your_value",
      "another_key": "another_value"
      // ... any other query parameters you sent
    }
  }
}

Important Notes:

HTTPS and HTTP Support: While HTTPS is recommended for secure connections (https://[YOUR_HOOLIT_HOST]), HoolIt also supports un-secure HTTP connections (http://[YOUR_HOOLIT_HOST]) for devices that might not support SSL. Use HTTP with caution, especially for sensitive data.
POST Requests and JSON Body: Sending JSON data in the body of a POST request is not currently supported. Only query parameters in GET requests are processed for dweeting. This is a planned feature for future releases.

Getting Dweets (Reading Data)

IMPORTANT: The functionality to retrieve past dweets (using /get/latest/dweet/for/ or /get/dweets/for/ endpoints from dweet.io) is currently NOT IMPLEMENTED in HoolIt.

HoolIt currently DOES NOT STORE ANY DWEET HISTORY.

In this version of HoolIt, there is no database or persistent storage for dweets. Data is only transiently available for real-time streaming (see below).

Future development may include options for storing dweet history, but for now, HoolIt is focused on real-time data streaming.

Real-time Streams (Listening for Data)

You can create a real-time subscription to dweets using Server-Sent Events (SSE). This allows you to receive dweets as they are sent to HoolIt for a specific "thing."

To listen for real-time dweets, make a request to:

https://[YOUR_HOOLIT_HOST]/listen/for/dweets/from/{your-thing-name}

Replace:

[YOUR_HOOLIT_HOST] with your HoolIt hostname or IP address.
{your-thing-name} with the "thing" name you want to subscribe to.

Example:

To listen for real-time dweets for the thing named my-sensor:

https://[YOUR_HOOLIT_HOST]/listen/for/dweets/from/my-sensor

(This endpoint is designed for server-side consumption and will not work directly in a standard web browser address bar due to the nature of Server-Sent Events.)

Using curl (or similar tools) to test:

From a Unix command line or terminal, you can use curl to observe the real-time stream:

curl -N https://[YOUR_HOOLIT_HOST]/listen/for/dweets/from/my-sensor

-N option in curl is important to disable buffering and see the stream in real-time.

Data Format in the Stream:

The server will keep the connection alive and send you dweets as they arrive in JSON format, like this:

{"thing":"{your-thing-name}","created":"2024-XX-XXTXX:XX:XX.XXXZ","content":{"your_key":"your_value", "another_key":"another_value"}}
{"thing":"{your-thing-name}","created":"2024-XX-XXTXX:XX:XX.XXXZ","content":{"another_key":"some_other_value"}}
// ... and so on, as new dweets arrive for "{your-thing-name}"

Each line in the stream is a new dweet. You will need to parse each line as a JSON object.

API Compatibility with dweet.io:

HoolIt is designed to be fully API compatible with dweet.io for the implemented features (dweeting and real-time streaming). You should be able to replace dweet.io URLs with your HoolIt host in your existing projects and code that used dweet.io for sending and listening to data, and it should function without code changes (for the compatible API parts).

Contributing:

HoolIt is an open-source project, and contributions are welcome! If you want to contribute to development, add features, or report issues, please check out the GitHub repository: https://github.com/mmahdium/HoolIt.

License:

https://github.com/mmahdium/HoolIt?tab=AGPL-3.0-1-ov-file#readme

Disclaimer:

HoolIt is an independent project and is not affiliated with or endorsed by the original dweet.io service. It is intended as a community-driven, open-source alternative. Use it at your own risk.