Skip to content

Latest commit

 

History

History
140 lines (88 loc) · 3.36 KB

README.md

File metadata and controls

140 lines (88 loc) · 3.36 KB
Raw

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.