1. LocalHash is currently streaming activities in real-time for the following publishers.

    Google Buzz MySpace Real Time Stream Twitter Streaming API Flickr Flickr
  2. Here's the current API (rev 0.3)

    Webhooks API


    /publishers/#{name}/subscriptions


    Substitute #{name} with the name of the publisher you would like to subscribe

    The API supports the following RESTful methods to receive publisher data.


    Send an HTTP GET request to show a previously created Subscription

    curl http://www.localhash.com/publishers/myspace/subscriptions/{id}

    Response

    Status Code 200 <?xml version="1.1" encoding="UTF-8"?><response><subscription hash="txn0ybs62v" callback="http://hostname" id="1"/></response>

    Send an HTTP POST request to create a Subscription

    curl -d "hub.callback=http://your.hostname.com&hub.lat=39.51&hub.lon=76.24"
                http://www.localhash.com/publishers/myspace/subscriptions

    Response

    Status Code 201 <?xml version="1.1" encoding="UTF-8"?><response><subscription hash="txn0ybs62v" callback="http://hostname" id="1"/></response>

    Send an HTTP DELETE request to remove a previously created Subscription

    curl -X DELETE http://www.localhash.com/publishers/myspace/subscriptions/{id}

    Response

    Status Code 202 <?xml version="1.1" encoding="UTF-8"?><response></response>

    Comet Streaming API


    /publishers/#{name}/subscriptions


    Substitute #{name} with the name of the publisher you would like to subscribe

    The API supports subscription based data streams.


    curl -d "hub.lat=34.052&hub.lon=-118.243&hub.precision=3"
                           http://www.localhash.com/publishers/myspace/stream

     

    Responses and Errors


    All response codes are included in the HTTP Status response header. Possible status codes include:

    • 200: Success (upon a successful GET request)
    • 201: Created (upon a successful POST request)
    • 202: Deleted (upon a successful DELETE request)
    • 400: Resource Invalid (improperly formatted request)
    • 401: Unauthorized (incorrect or missing authentication credentials)
    • 404: Resource Not Found
    • 405: Method Not Allowed
    • 406: Not Acceptable
    • 500: Application Error

     

    Background

    Here's some background information on Activity Streams, pubsubhubbub, and Geohash

    For those paying close attention, there's no security baked in...it's just a spike.