From what I understand, the "data" array in the actual JSON should look like this:
"data": [
{
"content_status": "captured.",
"content_url": "https://www.massis.com/aboutus.html",
"content_url_hash": "4467086592462243000",
"context_url": "www.massis.com",
"total_num_blocks": 4,
"total_num_words": 4
},
{
"label": "aboutus.html",
"my_num_blocks": 4,
"my_num_words": 4
}
],
An array of different objects can be defined in OpenAPI 3.0 ("openapi": "3.0.0") using the oneOf keyword:
{
"openapi": "3.0.0",
...
"components": {
"schemas": {
"inline_response_GET_XXX": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"oneOf": [
{ "$ref": "#/components/schemas/Schema1" },
{ "$ref": "#/components/schemas/Schema2" }
]
}
},
"total_word_count": {
"type": "integer",
"description": "The total number of words spidered on this node. This value includes words captured on child nodes.",
"example": 34
}
}
},
"Schema1": {
"type": "object",
"properties": {
"content_status": {
"type": "string",
"description": "There are several values that may appear here.",
"example": "captured."
},
"content_url": {
"type": "string",
"description": "The URL of the node.",
"example": "https://www.massis.com/aboutus.html"
},
"content_url_hash": {
"type": "string",
"description": "The hash of the URL of the node.",
"example": "4467086592462243000"
},
"context_url": {
"type": "string",
"description": "The URL of the node from which the node was spidered.",
"example": "www.massis.com"
},
"total_num_blocks": {
"type": "integer",
"description": "The total number of blocks in this node.",
"example": 4
},
"total_num_words": {
"type": "integer",
"description": "The total number of words in this node.",
"example": 4
}
}
},
"Schema2": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "A label for the node.",
"example": "aboutus.html"
},
"my_num_blocks": {
"type": "integer",
"description": "The number of blocks in this node.",
"example": 4
},
"my_num_words": {
"type": "integer",
"description": "The number of words in this node.",
"example": 4
}
}
}
}
}
}
If you use OpenAPI 2.0 ("swagger": "2.0") it doesn't support oneOf, but as a workaround you can use a single object schema containing properties of both objects (i.e. content_status, content_url, ..., label, my_num_blocks, ...) where all properties as optional.
