You need to enable JavaScript to run this app.
导航
请求结构
最近更新时间:2023.11.01 17:30:43首次发布时间:2023.05.19 15:47:09

本文介绍消息队列 RabbitMQ版 API 请求的组成结构。

请求URL

您可以通过发送 HTTPS POST 请求来调用 RabbitMQ 的 API 服务。HTTPS 请求 URL 的格式如下:

POST {URI-scheme}://{Endpoint}/?Action={Action}&Version={Version} HTTP/1.1

其中:

  • URI-scheme:表示用于传输请求的协议,当前所有 API 均采用 HTTPS 协议。
  • Endpoint:指定承载服务端点的服务器域名或 IP,即服务地址。消息队列 RabbitMQ版的 endpoint 为 rabbitmq.volcengineapi.com,详细说明请参考服务地址
  • Action:要执行的操作,此处请填写要调用的API接口。消息队列 RabbitMQ版的 API 接口请参考API概览
  • Version:API 版本号,格式为 YYYY-MM-DD 格式。消息队列 RabbitMQ版 V2 API 的版本号为固定值 2022-01-01

以开启公网访问(CreatePublicAddress)为例,未编码的 HTTPS 请求 URL 如下。

https://rabbitmq.volcengineapi.com/?Action=CreatePublicAddress&Version=2022-01-01

请求方法

请求方法用于向服务器传递当前请求的操作类型,消息队列 RabbitMQ版当前支持 POST 方法。

请求参数

火山引擎的 OpenAPI 请求包含两类参数,即公共请求参数和接口请求参数。其中,公共请求参数是每一个接口需要包含的,详细说明可参见公共参数。接口请求参数是各个接口特有的,详见各个接口描述。

请求头

HTTP 请求的请求头(Header)中需要指定 Content-Type 和请求鉴权信息等参数。Content-type 指定了请求消息体的结构化格式,消息队列 RabbitMQ版的 Content-Type 固定为 application/json。详细的参数列表及说明请参考公共参数

请求消息体

请求消息体主要传递业务相关的其他请求参数。若请求消息体中参数支持中文,则中文字符必须为 UTF-8 编码。
每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(即消息体为空),调用接口时,请参考各个 API 接口文档构建请求消息体。

发起请求

您可以使用 curlPostman 或直接编写代码等方式发送请求调用 API。例如 CreateInstancePublicAccess 接口的请求示例如下。

POST https://rabbitmq.volcengineapi.com/?Action=CreatePublicAddress&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rabbitmq.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/rabbitmq/request, SignedHeaders=x-date, Signature=********

{
   "InstanceId": "rbtmq-9283a61f****",
   "EipId": "eip-36sveyn9wy39c383g0wbs****"
}