caiovmv / rabbitmq-http

REST API for RabbitMQ, Write with Google Go(lang).

RabbitMQ HTTP API

REST HTTP API for RabbitMQ, it's not RabbitMQ Management Plugin.

Status:

Under active development.

Required:

* RabbitMQ (2.8+)
* Go(lang) (1.0.3)

Install:

$ go get github.com/streadway/amqp
$ go get github.com/smallfish/rabbitmq-http

Usage

• Start HTTP Server (see your $GOPATH/bin):

    # $GOPATH/bin/rabbitmq-http -address="127.0.0.1:8080" -amqp="amqp://guest:guest@localhost:5672/"
  

HTTP Response

200 OK
405 Method Not Allowed
500 Internal Server Error

API List

Exchange

• create new exchange:

    $ curl -i -X POST http://127.0.0.1:8080/exchange -d \
    '{"name": "e1", "type": "topic", "durable": true, "autodelete": false}'
     
    HTTP/1.1 200 OK
    Date: Thu, 21 Mar 2013 05:45:47 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    declare exchange ok
  

• delete exchange:

    $ curl -i -X DELETE http://127.0.0.1:8080/exchange -d \
    '{"name": "e1"}'
    
    HTTP/1.1 200 OK
    Date: Thu, 21 Mar 2013 05:46:21 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    delete exchange ok
  

Message

• publish new message:

    $ curl -i -X POST "http://127.0.0.1:8080/publish" -d \
    '{"exchange": "e1", "key": "bb", "deliverymode": 1, "priority": 99, "body": "hahaha"}'
  
    HTTP/1.1 200 OK
    Date: Mon, 25 Mar 2013 11:56:22 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    publish message ok
  

Queue

• create new queue:

    $ curl -i -X POST http://127.0.0.1:8080/queue -d \
    '{"name": "q1"}'
    
    HTTP/1.1 200 OK
    Date: Thu, 21 Mar 2013 05:47:11 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    declare queue ok
  

• delete queue:

    $ curl -i -X DELETE http://127.0.0.1:8080/queue -d \
    '{"name": "q1"}'
    
    HTTP/1.1 200 OK
    Date: Thu, 21 Mar 2013 05:48:05 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    delete queue ok
  

• bind keys to queue:

    $ curl -i -X POST http://127.0.0.1:8080/queue/bind -d \
    '{"queue": "q1", "exchange": "e1", "keys": ["aa", "bb", "cc"]}'
    
    HTTP/1.1 200 OK
    Date: Thu, 21 Mar 2013 05:48:43 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    bind queue ok
  

• unbind keys to queue:

    $ curl -i -X DELETE http://127.0.0.1:8080/queue/bind -d \
    '{"queue": "q1", "exchange": "e1", "keys": ["aa", "cc"]}'
    
    HTTP/1.1 200 OK
    Date: Thu, 21 Mar 2013 05:49:05 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    unbind queue ok
  

• consume queue:

    $ curl -i -X GET "http://127.0.0.1:8080/queue?name=q1" # more queues: "/queue?name=q1&name&q2"
  
    HTTP/1.1 200 OK
    Date: Fri, 22 Mar 2013 04:11:59 GMT
    Transfer-Encoding: chunked
    Content-Type: text/plain; charset=utf-8
  
    <DATA>\n
    <DATA>\n
    ...
  

Copyright and License

rabbitmq-http is licensed under the BSD license.