Skip to content

HTTP

HTTP binding。輸出的成員是 http,每個物件都帶 bindingVersion: 0.3.0

@httpOperation

typespec
extern dec httpOperation(target: Operation, config: valueof AsyncAPIHttpOperationBinding);
欄位型別必填
methodstring
queryunknown

套用在帶有 @send@receive 的 operation 上。

methodGETPUTPOSTPATCHDELETEHEADOPTIONSCONNECTTRACE 其中之一。

query 是型別為 object 且帶 properties 鍵的 Schema Object。這兩項都是 AsyncAPI 的規定。

@httpMessage

typespec
extern dec httpMessage(target: Model, config: valueof AsyncAPIHttpMessageBinding);
欄位型別必填
headersunknown
statusCodeint32

套用在同時帶有 @message 的 model 上。

headers 是型別為 object 且帶 properties 鍵的 Schema Object。

statusCode 是 RFC 9110 的狀態碼,範圍在 100 到 599 之間。AsyncAPI 規定它只適用於被 Operation Reply Object 指名的 message。emitter 不檢查這條規則,因為它跨兩個物件。