原文：http://hg.rabbitmq.com/rabbitmq-management/raw-file/3646dee55e02/priv/www-api/help.html

介紹

除了幫助頁面，所有URIs只會服務application/json類型的資源，并且需要HTTP基礎認證(使用標準RabbitMQ用戶數據庫). 默認用戶是guest/guest.

大多數URIs需要虛擬主機名稱作為其路徑的一部分, 因為名稱是虛擬主機的唯一標識符對象. 默認虛擬主機稱為"/", 它需要編碼為"%2f".

PUT一個資源會對其進行創建. 你上傳的JSON對象必須有某個鍵keys (下面文檔有描述)，其它的鍵會被忽略. 缺失鍵會引發錯誤.

在AMQP中，由于綁定沒有名稱或IDs，因此我們基于其所有屬性人工合成了一個. 

由于一般情況下很難預測這個名字, 你可以通過POST一個工廠URI來創建綁定.查看下面的例子.

注意事項

• arguments 字段會被忽略.你不創建一個隊列,交換器或使用參數進行綁定. 帶有參數的隊列，交換器或綁定也不會顯示這些參數．
• 權限偶爾才需要強制執行.如果一個用戶能用HTTP API進行認證，那么它們可以做任何事情.
• 從GET請求中返回的對象中包含許多與監控相關的信息. 它們是無證實的，并且將來可能要發生變化.

示例

下面有幾個快速例子,它們使用了Unix命令行工具curl:

• 獲取虛擬主機列表:

  $ curl -i -u guest:guest http://localhost:55672/api/vhosts 
  HTTP/1.1 200 OK 
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
  Date: Tue, 31 Aug 2010 15:46:59 GMT 
  Content-Type: application/json 
  Content-Length: 5  
  ["/"]

• 創建一個新虛擬主機:

  $ curl -i -u guest:guest -H "content-type:application/json" \   -XPUT http://localhost:55672/api/vhosts/foo 
  HTTP/1.1 204 No Content 
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
  Date: Fri, 27 Aug 2010 16:56:00 GMT 
  Content-Type: application/json 
  Content-Length: 0

  注意: 你必須將mime類型指定為application/json.

  Note: 在上傳的JSON對象中，對象名稱是不需要的，因為它已經包含在了URI中. 由于一個虛擬主機除了名稱外沒有其它屬性，這意味著你完全不需要指定一個body.

• 在默認虛擬主機中創建一個新的交換器:

  $ curl -i -u guest:guest -H "content-type:application/json" \   -XPUT -d'{"type":"direct","auto_delete":false,"durable":true,"arguments":[]}' \   http://localhost:55672/api/exchanges/%2f/my-new-exchange 
  HTTP/1.1 204 No Content 
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
  Date: Fri, 27 Aug 2010 17:04:29 GMT 
  Content-Type: application/json 
  Content-Length: 0

  注意: 在PUT或DELETE的響應中， 除非失敗了，否則我們絕不會返回一個body.

• 再刪除它:

  $ curl -i -u guest:guest -H "content-type:application/json" \   -XDELETE http://localhost:55672/api/exchanges/%2f/my-new-exchange 
  HTTP/1.1 204 No Content 
  Server: MochiWeb/1.1 WebMachine/1.7 (participate in the frantic) 
  Date: Fri, 27 Aug 2010 17:05:30 GMT 
  Content-Type: application/json 
  Content-Length: 0

參考

{"type":"direct","auto_delete":false,"durable":true,"arguments":[]}

{"auto_delete":false,"durable":true,"arguments":[]}

{"routing_key":"my_routing_key","arguments":[]}

{"password":"secret"}

{"scope":"client","configure":".*","write":".*","read":".*"}