{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "$id": "https://convocaliteraria.com/palmares.schema.json",
 "title": "Palmarés de Convoca",
 "description": "Quién ganó cada premio literario que sigue Convoca, con el libro publicado y de dónde sale el fallo. Solo fallos validados a mano o con dos fuentes. La compilación es CC BY 4.0.",
 "type": "object",
 "required": [
  "version",
  "generated_at",
  "count",
  "results"
 ],
 "properties": {
  "$schema": {
   "type": "string",
   "description": "Este esquema."
  },
  "version": {
   "type": "string",
   "description": "Versión del formato."
  },
  "generated_at": {
   "type": "string",
   "description": "Cuándo se generó.",
   "format": "date-time"
  },
  "license": {
   "type": "string",
   "description": "La licencia de la compilación: CC BY 4.0."
  },
  "attribution": {
   "type": "string",
   "description": "Cómo citarla."
  },
  "count": {
   "type": "integer",
   "description": "Cuántos fallos trae."
  },
  "results": {
   "type": "array",
   "items": {
    "$ref": "#/$defs/fallo"
   }
  }
 },
 "$defs": {
  "fallo": {
   "type": "object",
   "required": [
    "prize_id",
    "prize_name",
    "year",
    "author",
    "status",
    "confidence"
   ],
   "properties": {
    "prize_id": {
     "type": "string",
     "description": "El premio en el registro de Convoca."
    },
    "prize_name": {
     "type": "string",
     "description": "El nombre del premio."
    },
    "prize_url": {
     "type": [
      "string",
      "null"
     ],
     "description": "Su página en Convoca: la convocatoria, las ediciones, el palmarés y los libros."
    },
    "entity": {
     "type": [
      "string",
      "null"
     ],
     "description": "Quién lo convoca."
    },
    "year": {
     "type": "integer",
     "description": "El año del premio."
    },
    "edition": {
     "type": [
      "integer",
      "null"
     ],
     "description": "El número de edición, si se conoce."
    },
    "work": {
     "type": [
      "string",
      "null"
     ],
     "description": "La obra premiada. null si el fallo no la nombra."
    },
    "author": {
     "type": "string",
     "description": "Quién ganó."
    },
    "book": {
     "type": [
      "object",
      "null"
     ],
     "description": "El libro publicado, si lo hay. En un volumen colectivo, title es el del libro y work, la obra premiada.",
     "properties": {
      "title": {
       "type": [
        "string",
        "null"
       ],
       "description": "El título del libro."
      },
      "isbn": {
       "type": "string",
       "description": "ISBN-13."
      },
      "publisher": {
       "type": [
        "string",
        "null"
       ],
       "description": "La editorial."
      },
      "published": {
       "type": [
        "string",
        "null"
       ],
       "description": "La fecha de publicación (AAAA-MM-DD)."
      },
      "language": {
       "type": [
        "string",
        "null"
       ],
       "description": "La lengua del libro, como la da la ficha editorial."
      },
      "url": {
       "type": [
        "string",
        "null"
       ],
       "description": "Su ficha en Convoca, si la tiene."
      }
     }
    },
    "status": {
     "type": "string",
     "description": "fallado: el premio se dio. publicado: además, el libro ya salió."
    },
    "confidence": {
     "type": "string",
     "description": "Cómo se validó: oficial (la web del premio), oficial-editorial (la editorial que lo publica), prensa (un medio) o verificado (a mano, con dos fuentes)."
    },
    "sources": {
     "type": "array",
     "description": "Dónde se anunció el fallo.",
     "items": {
      "type": "object",
      "properties": {
       "name": {
        "type": [
         "string",
         "null"
        ],
        "description": "El medio o la web."
       },
       "url": {
        "type": "string",
        "description": "La noticia o la página."
       }
      }
     }
    }
   }
  }
 }
}