Skip to content

HTTP message binding

Contains information about the message representation in HTTP.

Structure

copy

Examples

json
{
    "headers": {
        "type": "object",
        "properties": {
            "Content-Type": {
                "type": "string",
                "enum": [
                    "application/json"
                ]
            }
        }
    },
    "bindingVersion": "0.3.0"
}

Changelog

Added

statusCode

The HTTP response status code according to RFC 9110.

statusCode is only relevant for messages referenced by the Operation Reply Object, as it defines the status code for the response.

In all other cases, this value can be safely ignored.

json
{
    "statusCode": { 
        "type": "number", 
        "description": "The HTTP response status code according to [RFC 9110](https://httpwg.org/specs/rfc9110.html#overview.of.status.codes). `statusCode` is only relevant for messages referenced by the [Operation Reply Object](https://www.asyncapi.com/docs/reference/specification/v3.0.0#operationReplyObject), as it defines the status code for the response. In all other cases, this value can be safely ignored."
    } 
}