IoT Messaging

Base URL for requests

http://verizonventures-prod.apigee.net/dweet

dweets: create or read dweets

 

POST    /dweet/for/{thing} - Create a dweet for a thing.

Parameter Value Description Parameter Type Data Type
thing (required) A unique name of a thing. It is recommended that you use a GUID as to avoid name collisions. path string
key (optional) A valid key for a locked thing. If the thing is not locked, this can be ignored. query string
content (required) The actual content of the string. Can be any valid JSON string. Use content type: application/json. body string

 

GET    /get/latest/dweet/for/{thing} - Read the latest dweet for a thing.

Parameter Value Description Parameter Type Data Type
thing (required) A unique name of a thing. path string
key (optional) A valid key for a locked thing. If the thing is not locked, this can be ignored. query string

 

GET    /get/dweets/for/{thing} - Read all of the saved dweets (up to last 500) for a thing.

Parameter Value Description Parameter Type Data Type
thing (required) A unique name of a thing. path string
key (optional) A valid key for a locked thing. If the thing is not locked, this can be ignored. query string

 

GET    /listen/for/dweets/from/{thing} - Listen for dweets from a thing.

This function uses HTTP chunked responses. Try something like:

curl --raw http://verizonventures-prod.apigee.net/dweet/listen/for/dweets/from/{thing}

 


 

alerts: alerts for things

 

GET    /alert/{who}/when/{thing}/{condition} - Create an alert for a thing. A thing must be locked before an alert can be set.

Parameter Value Description Parameter Type Data Type
who (required) A comma separated list of Email addresses to send the alert to. path string
thing (required) A unique name of a thing. It is recommended that you use a GUID as to avoid name collisions. path string
condition (required) A condition that returns a string or a true value if a condition is met. path string
key (required) A valid key for a locked thing. If the thing is not locked, this can be ignored. query string

 

GET    /get/alert/for/{thing} - Get the alert attached to a thing.

Parameter Value Description Parameter Type Data Type
thing (required) A unique name of a thing. path string
key (required) A valid key for a locked thing. If the thing is not locked, this can be ignored. query string

 

GET    /remove/alert/for/{thing} - Remove an alert for a thing.

Parameter Value Description Parameter Type Data Type
thing (required) A unique name of a thing. path string
key (required) A valid key for a locked thing. If the thing is not locked, this can be ignored. query string

 

 

 

locks: lock and unlock things

 

GET    /lock/{thing} - Reserve and lock a thing.

Parameter Value Description Parameter Type Data Type
thing (required) A unique name of a thing. path string
lock (required) A valid dweet.io lock. query string
key (required) A valid dweet.io master key. query string

 

GET    /unlock/{thing} - Unlock a thing.

Parameter Value Description Parameter Type Data Type
thing (required) A unique name of a thing. path string
key (required) A valid dweet.io master key. query string

 

GET    /remove/lock/{lock} - Remove a lock from thing.

Parameter Value Description Parameter Type Data Type
lock (required) A valid dweet.io lock. path string
key (required) A valid dweet.io master key. query string