Respuestas

Anatomía de la respuesta

Para entender cómo se devuelven los datos, vamos a desglosar la anatomía de una respuesta de ejemplo. En este caso, nos mantendremos con nuestro ejemplo anterior de los productos exportados por España en 2023:

https://api-v2.oec.world/tesseract/data.jsonrecords?cube=trade_i_baci_a_22&drilldowns=HS4,Exporter+Country,Importer+Country,Year&measures=Trade+Value&include=Exporter+Country:euesp;Year:2023&limit=2,0&token=6b540954e368f971

Formato de la respuesta

La respuesta será un objeto JSON con la siguiente estructura:

{
  "annotations": {
    "table": "HS6 REV. 2022 (2022 - 2023)",
    "dataset_link": "http://www.cepii.fr/CEPII/en/bdd_modele/presentation.asp?id=37",
    "topic": "International",
    "subtopic": "Trade",
    "source_description": "Product Trade by Year and Country (HS 6-digit depth)",
    "dataset_name": "HS6 REV. 2022 (2022 - 2023)",
    "source_name": "BACI"
  },
  "page": {
    "limit": 2,
    "offset": 0,
    "total": 108101
  },
  "columns": [
    "Exporter Country ID",
    "Exporter Country",
    "HS4 ID",
    "HS4",
    "Importer Country ID",
    "Importer Country",
    "Year",
    "Trade Value"
  ],
  "data": [
    {
      "Exporter Country ID": "euesp",
      "Exporter Country": "Spain",
      "HS4 ID": 10101,
      "HS4": "Horses",
      "Importer Country ID": "aflby",
      "Importer Country": "Libya",
      "Year": 2023,
      "Trade Value": 235109
    },
    {
      "Exporter Country ID": "euesp",
      "Exporter Country": "Spain",
      "HS4 ID": 10101,
      "HS4": "Horses",
      "Importer Country ID": "afmar",
      "Importer Country": "Morocco",
      "Year": 2023,
      "Trade Value": 628207
    }
  ]
}

1. Anotaciones

El objeto annotations contiene metadatos sobre el conjunto de datos, como el nombre de la fuente, la descripción de la fuente, el tema, el subtema y el nombre del conjunto de datos.

2. Paginado

El objeto page contiene metadatos sobre la respuesta de datos, como el límite, el offset y el número total de registros disponible para el conjunto de parametros.

3. Columnas

El objeto columns contiene la lista de columnas en el conjunto de datos. Ten en cuenta que, aunque no especificamos incluir las columnas de ID en la petición, estas se devuelven de igual forma.

4. Datos

El objeto data contiene la lista de registros en el conjunto de datos. Las claves son los nombres de las columnas (incluyendo tanto columnas de drilldown como de medidas) y los valores son los valores de esa columna para cada registro.