在将本地音视频流发布到 WTN 之前，你应创建发布资源。

关于发布资源，参看发布资源和订阅资源。

使用说明

接口行为

调用此接口，向 WTN 服务端发送 SDP Offer。如果调用成功，WTN 服务端会创建发布资源，发布客户端会收到来自 WTN 服务端的 SDP Answer。

订阅鉴权

创建发布资源时，你可以通过调整 Token 设置来决定是否开启订阅鉴权。关于具体设置，参看接口鉴权。

注意事项

后续操作

重复发布

如果创建发布资源前，具有相同的 AppID 和 StreamID 的发布资源已创建，此时后发布的用户会收到 431 错误码，这是默认行为。针对这类 case 有疑问或特殊业务逻辑，可以联系我们技术支持。

请求说明

请求参数

Path

参数	类型	是否必选	示例值	描述
Content-Type	String	是	application/sdp	请求内容类型。固定值：application/sdp。
Authorization	String	否	{TokenType} {Token}	当开启了推流鉴权时，必须传入此参数；未开启推流鉴权时，不传入此参数。 TokenType：固定值： Bearer。 Token：参见接口鉴权。
Feedback-Info	String	否	/	媒体服务器节点相关信息。如果创建的 PeerConnection 本次返回RTCPeerConnection.connectionState == failed即 ICE 建联失败，你可在此字段填入上次调用该接口响应 Header 头中 Feedback-Info 和 Query 中 ClientID 的值重新调用该接口创建发布资源，服务端会自动切换媒体服务器节点。更多信息，请参见构建基础应用。 Tip 使用该参数时，你无需关注该字段中的内容，直接将上次请求返回的 Feedback-Info值传入即可。

Query

参数	类型	是否必选	示例值	描述
BusinessID	string	否	www.volc.com	业务 ID，用来唯一标识同一 AppId 下的不同业务。可在 WTN 控制台创建和获取。同一个 AppId 下业务 ID 不允许重复。长度不超过 64 个字符。取值范围为：数字、字母、_、-、@、.。
SessionID	String	否	Session123	客户端生成的 ID，用于日志排查。
MuteAudio	Bool	否	false	是否发布音频数据。 true ：不发送音频数据； false ：发送音频数据。默认值为 false 。
MuteVideo	Bool	否	false	是否发布视频数据。 true ：不发送视频数据； false ：发送视频数据。默认值为 false 。
ClientIP	String	否	123.XX.XX.85	客户端的公网 IP 地址（仅支持 IPV4）。WTN 服务端会根据它为客户端分配最佳媒体服务器节点。默认值为发起 HTTP 请求的 IP。
ClientID	String	否	Client123	客户端 ID，用于标识一个用户。 Tip 建议在每次请求时都填入客户端 ID，方便出现问题时快速定位。

Body

参数	类型	是否必选	示例值	描述
data-raw	String	是	<SDP Offer>	向服务端发送 SDP Offer

响应结果

成功响应示例

异常响应示例

请求示例

返回示例

状态码

您可访问状态码，获取更多状态码信息。