changedInput schema / properties / id / description
Previous value: -"Boxerbook bout id (from a schedule, results, search or a /bouts/<id>/<slug> url)"New value: +"Boxerbook bout id (the id of a bout in any Boxerbook answer, or the number in a boxerbook.com/bouts/<id>/<slug> url)"
addedInput schema / properties / lang
Added value: +{
+ "default": "en",
+ "description": "the user's language: en (default), es, ru or ja; the boxerbook.com page links of the answer follow it (a page without a translation keeps its English link)",
+ "enum": [
+ "en",
+ "es",
+ "ru",
+ "ja"
+ ],
+ "type": "string"
+}
addedInput schema / properties / query
Added value: +{
+ "description": "instead of id: two boxers as \"A vs B\", two surnames, e.g. \"Fury vs Joshua\"",
+ "maxLength": 120,
+ "minLength": 3,
+ "type": "string"
+}
removedInput schema / required
Removed value: -[
- "id"
-]
addedOutput schema / properties / cite
Added value: +{
+ "description": "the markdown link to quote with any fact of this answer: Source: [Boxerbook](<url of the main page>)",
+ "type": "string"
+}
addedOutput schema / properties / display
Added value: +{
+ "description": "the order to show the two names in: ['a','b'] or ['b','a'] (the better-known boxer first, as boxerbook.com does: more Wikipedia language links, then the Boxerbook rating, then pro bouts). a, b, winner, forecast.p_a and market.p_a keep their meaning (side a); only the display order changes",
+ "items": {
+ "enum": [
+ "a",
+ "b"
+ ]
+ },
+ "maxItems": 2,
+ "minItems": 2,
+ "type": "array"
+}
removedOutput schema / properties / event / oneOf
Removed value: -[
- {
- "properties": {
- "city": {
- "type": [
- "string",
- "null"
- ]
- },
- "country": {
- "type": [
- "string",
- "null"
- ]
- },
- "date": {
- "type": [
- "string",
- "null"
- ]
- },
- "id": {
- "type": "integer"
- },
- "promoter": {
- "type": [
- "string",
- "null"
- ]
- },
- "url": {
- "type": "string"
- },
- "venue": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
-]
addedOutput schema / properties / event / properties
Added value: +{
+ "city": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "country": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "date": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "integer"
+ },
+ "promoter": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ },
+ "venue": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+}
addedOutput schema / properties / event / type
Added value: +[
+ "object",
+ "null"
+]
addedOutput schema / properties / head_to_head
Added value: +{
+ "description": "the two boxers named in the query: whether and how often they met, the bout between them that is scheduled, and each side's record, last fights and next bout",
+ "properties": {
+ "a": {
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "last_fights": {
+ "description": "the last three completed bouts, newest first",
+ "items": {
+ "properties": {
+ "date": {
+ "type": "string"
+ },
+ "id": {
+ "type": "integer"
+ },
+ "method": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "opponent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "result": {
+ "description": "W, L, D or NC for this side",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "round": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "date",
+ "url"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_bout": {
+ "properties": {
+ "date": {
+ "type": "string"
+ },
+ "id": {
+ "type": "integer"
+ },
+ "opponent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "record": {
+ "description": "W-L-D today",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "url",
+ "last_fights"
+ ],
+ "type": "object"
+ },
+ "b": {
+ "properties": {
+ "id": {
+ "type": "integer"
+ },
+ "last_fights": {
+ "description": "the last three completed bouts, newest first",
+ "items": {
+ "properties": {
+ "date": {
+ "type": "string"
+ },
+ "id": {
+ "type": "integer"
+ },
+ "method": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "opponent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "result": {
+ "description": "W, L, D or NC for this side",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "round": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "date",
+ "url"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "name": {
+ "type": "string"
+ },
+ "next_bout": {
+ "properties": {
+ "date": {
+ "type": "string"
+ },
+ "id": {
+ "type": "integer"
+ },
+ "opponent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "record": {
+ "description": "W-L-D today",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "url",
+ "last_fights"
+ ],
+ "type": "object"
+ },
+ "bouts": {
+ "description": "the bouts between them, newest first (at most 5)",
+ "items": {
+ "properties": {
+ "date": {
+ "type": "string"
+ },
+ "id": {
+ "type": "integer"
+ },
+ "method": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "round": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "status": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ },
+ "winner": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "id",
+ "date",
+ "status",
+ "url"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "met": {
+ "description": "completed bouts between them",
+ "type": "integer"
+ },
+ "scheduled": {
+ "properties": {
+ "date": {
+ "type": "string"
+ },
+ "id": {
+ "type": "integer"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "one sentence: how often they met and with what result, or that they never fought; the scheduled date; both records",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "met",
+ "bouts",
+ "a",
+ "b"
+ ],
+ "type": "object"
+}
addedOutput schema / properties / note
Added value: +{
+ "description": "when the two never met: the head to head summary (no bout fields then)",
+ "type": "string"
+}
addedOutput schema / properties / story
Added value: +{
+ "description": "«The story of the fight» of a completed bout, in English: a report written from the broadcast commentary, Boxerbook data and the press, every sentence checked against its sources (the bout page lists them); paragraphs separated by a blank line, text only (the charts are on the page). Absent when the bout has none",
+ "type": "string"
+}
changedOutput schema / required
Previous value: -[
- "id",
- "date",
- "status",
- "a",
- "b",
- "broadcasts",
- "sources",
- "fight_week",
- "url",
- "attribution",
- "as_of"
-]New value: +[
+ "cite",
+ "url",
+ "attribution",
+ "as_of"
+]