API de la Secretaria Virtual

Autenticació

Respostes

• 200HealthDtoEl proceso responde (no mira dependencias)

  • statusstringobligatori

    Valors:"ok"

  • versionstringobligatori
  • timestring (date-time)obligatori

  {
    "status": "ok",
    "version": "texto",
    "time": "2026-10-06T10:00:00.000Z"
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Respostes

• 200ReadyDtoBase de datos y Valkey comprobados ahora mismo

  • databasestringobligatori

    Valors:"ok""error"

  • valkeystringobligatori

    not_configured si no hay VALKEY_URL (las cuotas van en memoria)

    Valors:"ok""error""not_configured"

  • jobsJobsDtoobligatori
    JobsDto

    • backendstringobligatori

      Dónde vive la cola de trabajos en segundo plano (envíos, PDF, lotes): hoy siempre en memoria del proceso, con lo duradero en la base

      Valors:"memory"

    • queuednumberobligatori
    • runningnumberobligatori
    • capacitynumberobligatori

      Tope de la cola

  {
    "database": "ok",
    "valkey": "ok",
    "jobs": {
      "backend": "memory",
      "queued": 0,
      "running": 0,
      "capacity": 0
    }
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 503ErrorBodyDtoLa base no responde, o Valkey está configurado y no responde

  Model: ErrorBodyDto

  {
    "code": "unavailable",
    "message": "No disponible ahora mismo",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Respostes

• 200ExerciseDto[]

  ExerciseDto[]

  • idstring (uuid)obligatori
  • labelstringobligatori

    Exemple: "2026-27"

  • opensAtstring (date-time)obligatori
  • closesAtstring (date-time) | nullopcional
  • isCurrentbooleanobligatori
  • phasestringobligatori

    Valors:"planned""open""census_closed""constitution""closed"

  • allowedOperations"census.register" | "census.leave" | "census.office" | "census.edit"[]obligatori

    Operaciones del censo que la fase permite (ADR 0013); la web solo esconde botones

    Valors:"census.register""census.leave""census.office""census.edit"

  • categoryCutoffstring (date)obligatori

    Fecha de corte para la categoría (14 años cumplidos a San José, configurable)

  • adultAgenumberobligatori

    Años cumplidos a la fecha de corte para pasar a mayores en este ejercicio (ADR 0018)

  • sheetsDeadlinestring (date-time) | nullopcional

    Fecha límite de entrega de las Hojas de Constitución (spec 16; informativa)

  • requiredOffices"presidente" | "vicepresidente_1" | "vicepresidente_2" | "vicepresidente_3" | "vicepresidente_4" | "secretario" | "vicesecretario" | "contador" | "tesorero" | "vicecontador" | "delegado_infantiles" | "delegado_1" | "delegado_2" | "delegado_3" | "delegado_4" | "delegado_5" | "delegado_6" | "delegado_7" | "bibliotecario_archivero" | "fallera_mayor" | "vocal" | "miembro_junta_local" | "directiva_agrupacion"[]obligatori

    Cargos obligatorios de la comprobación de censos (spec 16)

    Valors:"presidente""vicepresidente_1""vicepresidente_2""vicepresidente_3""vicepresidente_4""secretario""vicesecretario""contador""tesorero""vicecontador""delegado_infantiles""delegado_1""delegado_2""delegado_3""delegado_4""delegado_5""delegado_6""delegado_7""bibliotecario_archivero""fallera_mayor""vocal""miembro_junta_local""directiva_agrupacion"

  [
    {
      "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "label": "2026-27",
      "opensAt": "2026-10-06T10:00:00.000Z",
      "closesAt": "2026-10-06T10:00:00.000Z",
      "isCurrent": true,
      "phase": "planned",
      "allowedOperations": [
        "census.register"
      ],
      "categoryCutoff": "2026-10-06",
      "adultAge": 0,
      "sheetsDeadline": "2026-10-06T10:00:00.000Z",
      "requiredOffices": [
        "presidente"
      ]
    }
  ]

• 401ErrorBodyDtounauthorized: sin sesión, o con una clave o un token que no vale (cabecera WWW-Authenticate)

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 403ErrorBodyDtoforbidden: la cuenta ve el recurso pero no tiene la acción

  Model: ErrorBodyDto

  {
    "code": "forbidden",
    "message": "No tienes permiso para esta acción",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Respostes

• 200ExerciseDto

  • idstring (uuid)obligatori
  • labelstringobligatori

    Exemple: "2026-27"

  • opensAtstring (date-time)obligatori
  • closesAtstring (date-time) | nullopcional
  • isCurrentbooleanobligatori
  • phasestringobligatori

    Valors:"planned""open""census_closed""constitution""closed"

  • allowedOperations"census.register" | "census.leave" | "census.office" | "census.edit"[]obligatori

    Operaciones del censo que la fase permite (ADR 0013); la web solo esconde botones

    Valors:"census.register""census.leave""census.office""census.edit"

  • categoryCutoffstring (date)obligatori

    Fecha de corte para la categoría (14 años cumplidos a San José, configurable)

  • adultAgenumberobligatori

    Años cumplidos a la fecha de corte para pasar a mayores en este ejercicio (ADR 0018)

  • sheetsDeadlinestring (date-time) | nullopcional

    Fecha límite de entrega de las Hojas de Constitución (spec 16; informativa)

  • requiredOffices"presidente" | "vicepresidente_1" | "vicepresidente_2" | "vicepresidente_3" | "vicepresidente_4" | "secretario" | "vicesecretario" | "contador" | "tesorero" | "vicecontador" | "delegado_infantiles" | "delegado_1" | "delegado_2" | "delegado_3" | "delegado_4" | "delegado_5" | "delegado_6" | "delegado_7" | "bibliotecario_archivero" | "fallera_mayor" | "vocal" | "miembro_junta_local" | "directiva_agrupacion"[]obligatori

    Cargos obligatorios de la comprobación de censos (spec 16)

    Valors:"presidente""vicepresidente_1""vicepresidente_2""vicepresidente_3""vicepresidente_4""secretario""vicesecretario""contador""tesorero""vicecontador""delegado_infantiles""delegado_1""delegado_2""delegado_3""delegado_4""delegado_5""delegado_6""delegado_7""bibliotecario_archivero""fallera_mayor""vocal""miembro_junta_local""directiva_agrupacion"

  {
    "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
    "label": "2026-27",
    "opensAt": "2026-10-06T10:00:00.000Z",
    "closesAt": "2026-10-06T10:00:00.000Z",
    "isCurrent": true,
    "phase": "planned",
    "allowedOperations": [
      "census.register"
    ],
    "categoryCutoff": "2026-10-06",
    "adultAge": 0,
    "sheetsDeadline": "2026-10-06T10:00:00.000Z",
    "requiredOffices": [
      "presidente"
    ]
  }

• 401ErrorBodyDtounauthorized: sin sesión, o con una clave o un token que no vale (cabecera WWW-Authenticate)

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 403ErrorBodyDtoforbidden: la cuenta ve el recurso pero no tiene la acción

  Model: ErrorBodyDto

  {
    "code": "forbidden",
    "message": "No tienes permiso para esta acción",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Respostes

• 200EntityDto

  • idstring (uuid)obligatori
  • kindstringobligatori

    Valors:"comision""junta_local""falla_municipio""agrupacion"

  • officialNumberstringobligatori
  • slugstringobligatori
  • namestringobligatori
  • capabilitiesEntityCapabilitiesDtoobligatori
    EntityCapabilitiesDto

    • hasCensusbooleanobligatori

      Tiene censo propio (comisiones y fallas de municipio)

    • awardsEligiblebooleanobligatori

      Puede pedir recompensas

    • hasFallasbooleanobligatori

      Tiene fallas a su cargo (juntas locales y agrupaciones)

    • privateHomestringobligatori

      Su Zona Privada en la web de las fallas

      Valors:"panel""mis-fallas"

  • legacyCodestring | nullopcional

    Código del sistema viejo (fal35303)

  • sectorstring | nullopcional
  • taxIdstring | nullopcional

    NIF de la entidad (solo lo cambia la Junta)

  • addressstring | nullopcional
  • citystring | nullopcional
  • postalCodestring | nullopcional
  • phonestring | nullopcional

    Teléfono del casal, solo dígitos

  • publicEmailstring | nullopcional

    Correo público (directorios de JCF)

  • localBoardEntityRefDto | nullopcional

    Junta local de la que cuelga

    object

    • idstring (uuid)obligatori
    • kindstringobligatori

      Valors:"comision""junta_local""falla_municipio""agrupacion"

    • officialNumberstringobligatori
    • slugstringobligatori
    • namestringobligatori
  • groupingEntityRefDto | nullopcional

    Agrupación a la que pertenece

    object

    • idstring (uuid)obligatori
    • kindstringobligatori

      Valors:"comision""junta_local""falla_municipio""agrupacion"

    • officialNumberstringobligatori
    • slugstringobligatori
    • namestringobligatori
  • editableFields"address" | "city" | "postalCode" | "phone" | "publicEmail" | "name" | "officialNumber" | "sector" | "taxId" | "localBoardId" | "groupingId"[]obligatori

    Campos que ESTA cuenta puede cambiar (la API decide; la web solo pinta)

    Valors:"address""city""postalCode""phone""publicEmail""name""officialNumber""sector""taxId""localBoardId""groupingId"

  {
    "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
    "kind": "comision",
    "officialNumber": "texto",
    "slug": "texto",
    "name": "texto",
    "capabilities": {
      "hasCensus": true,
      "awardsEligible": true,
      "hasFallas": true,
      "privateHome": "panel"
    },
    "legacyCode": "texto",
    "sector": "texto",
    "taxId": "texto",
    "address": "texto",
    "city": "texto",
    "postalCode": "texto",
    "phone": "texto",
    "publicEmail": "texto",
    "localBoard": {
      "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "kind": "comision",
      "officialNumber": "texto",
      "slug": "texto",
      "name": "texto"
    },
    "grouping": {
      "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "kind": "comision",
      "officialNumber": "texto",
      "slug": "texto",
      "name": "texto"
    },
    "editableFields": [
      "address"
    ]
  }

• 401ErrorBodyDtounauthorized: sin sesión, o con una clave o un token que no vale (cabecera WWW-Authenticate)

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 403ErrorBodyDtoforbidden: la cuenta ve el recurso pero no tiene la acción

  Model: ErrorBodyDto

  {
    "code": "forbidden",
    "message": "No tienes permiso para esta acción",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Paràmetres

• idstringcamíobligatori

Respostes

• 200EntityDto

  • idstring (uuid)obligatori
  • kindstringobligatori

    Valors:"comision""junta_local""falla_municipio""agrupacion"

  • officialNumberstringobligatori
  • slugstringobligatori
  • namestringobligatori
  • capabilitiesEntityCapabilitiesDtoobligatori
    EntityCapabilitiesDto

    • hasCensusbooleanobligatori

      Tiene censo propio (comisiones y fallas de municipio)

    • awardsEligiblebooleanobligatori

      Puede pedir recompensas

    • hasFallasbooleanobligatori

      Tiene fallas a su cargo (juntas locales y agrupaciones)

    • privateHomestringobligatori

      Su Zona Privada en la web de las fallas

      Valors:"panel""mis-fallas"

  • legacyCodestring | nullopcional

    Código del sistema viejo (fal35303)

  • sectorstring | nullopcional
  • taxIdstring | nullopcional

    NIF de la entidad (solo lo cambia la Junta)

  • addressstring | nullopcional
  • citystring | nullopcional
  • postalCodestring | nullopcional
  • phonestring | nullopcional

    Teléfono del casal, solo dígitos

  • publicEmailstring | nullopcional

    Correo público (directorios de JCF)

  • localBoardEntityRefDto | nullopcional

    Junta local de la que cuelga

    object

    • idstring (uuid)obligatori
    • kindstringobligatori

      Valors:"comision""junta_local""falla_municipio""agrupacion"

    • officialNumberstringobligatori
    • slugstringobligatori
    • namestringobligatori
  • groupingEntityRefDto | nullopcional

    Agrupación a la que pertenece

    object

    • idstring (uuid)obligatori
    • kindstringobligatori

      Valors:"comision""junta_local""falla_municipio""agrupacion"

    • officialNumberstringobligatori
    • slugstringobligatori
    • namestringobligatori
  • editableFields"address" | "city" | "postalCode" | "phone" | "publicEmail" | "name" | "officialNumber" | "sector" | "taxId" | "localBoardId" | "groupingId"[]obligatori

    Campos que ESTA cuenta puede cambiar (la API decide; la web solo pinta)

    Valors:"address""city""postalCode""phone""publicEmail""name""officialNumber""sector""taxId""localBoardId""groupingId"

  {
    "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
    "kind": "comision",
    "officialNumber": "texto",
    "slug": "texto",
    "name": "texto",
    "capabilities": {
      "hasCensus": true,
      "awardsEligible": true,
      "hasFallas": true,
      "privateHome": "panel"
    },
    "legacyCode": "texto",
    "sector": "texto",
    "taxId": "texto",
    "address": "texto",
    "city": "texto",
    "postalCode": "texto",
    "phone": "texto",
    "publicEmail": "texto",
    "localBoard": {
      "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "kind": "comision",
      "officialNumber": "texto",
      "slug": "texto",
      "name": "texto"
    },
    "grouping": {
      "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "kind": "comision",
      "officialNumber": "texto",
      "slug": "texto",
      "name": "texto"
    },
    "editableFields": [
      "address"
    ]
  }

• 401ErrorBodyDtounauthorized: sin sesión, o con una clave o un token que no vale (cabecera WWW-Authenticate)

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 403ErrorBodyDtoforbidden: la cuenta ve el recurso pero no tiene la acción

  Model: ErrorBodyDto

  {
    "code": "forbidden",
    "message": "No tienes permiso para esta acción",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Paràmetres

• idstringcamíobligatori
• exercisestringconsultaopcional

  Id o etiqueta del ejercicio de la entrada; por defecto, el en curso

Respostes

• 200ProfileDto

  • idstring (uuid)obligatori
  • entityEntityRefDtoobligatori
    EntityRefDto

    • idstring (uuid)obligatori
    • kindstringobligatori

      Valors:"comision""junta_local""falla_municipio""agrupacion"

    • officialNumberstringobligatori
    • slugstringobligatori
    • namestringobligatori
  • jcfCensusNumberstring | nullopcional

    «Num. Censo en JCF» de ESTA ficha

  • givenNamestringobligatori
  • familyNamestringobligatori
  • birthDatestring (date) | nullopcional
  • sexstring | nullopcional

    Valors:"hombre""mujer"

  • idKindstringobligatori

    Valors:"dni""menor""extranjero"

  • nationalIdstring | nullopcional
  • referencestring | nullopcional
  • addressstring | nullopcional
  • citystring | nullopcional
  • postalCodestring | nullopcional
  • phone1string | nullopcional
  • phone2string | nullopcional
  • emailstring | nullopcional
  • exercisestringobligatori

    Ejercicio de entry

    Exemple: "2026-27"

  • entryCensusRowDto | nullopcional

    Entrada de la ficha en ese ejercicio (null = no está en ese censo)

    object

    • entryIdstring (uuid)obligatori
    • profileIdstring (uuid)obligatori
    • censusNumbernumber | nullopcional

      Nº de censo en falla

    • givenNamestringobligatori
    • familyNamestringobligatori
    • categorystringobligatori

      Valors:"infantil""mayor"

    • officestring | nullopcional

      Valors:"presidente""vicepresidente_1""vicepresidente_2""vicepresidente_3""vicepresidente_4""secretario""vicesecretario""contador""tesorero""vicecontador""delegado_infantiles""delegado_1""delegado_2""delegado_3""delegado_4""delegado_5""delegado_6""delegado_7""bibliotecario_archivero""fallera_mayor""vocal""miembro_junta_local""directiva_agrupacion"

    • joinedAtstring (date-time)obligatori
    • leftAtstring (date-time) | nullopcional
    • leaveReasonstring | nullopcional

      Valors:"voluntaria""traslado""fallecimiento""expulsion""otro"

    • leaveNotestring | nullopcional
  • awardsAwardsDtoobligatori
    AwardsDto

    • distintiuArgentnumber | nullopcional
    • distintiuOrnumber | nullopcional
    • bunyolArgentnumber | nullopcional
    • bunyolOrnumber | nullopcional
    • bunyolFullesnumber | nullopcional
    • bunyolBrillantsnumber | nullopcional
  • historyHistoryRowDto[]obligatori

    Historial de la PERSONA (todas sus fichas), en lectura, como hoy

    HistoryRowDto

    • exercisestringobligatori

      Exemple: "2025-26"

    • entityOfficialNumberstringobligatori

      Número oficial de la falla

    • entityNamestringobligatori
    • categorystringobligatori

      Valors:"infantil""mayor"

    • censusNumbernumber | nullopcional
    • officestring | nullopcional

      Valors:"presidente""vicepresidente_1""vicepresidente_2""vicepresidente_3""vicepresidente_4""secretario""vicesecretario""contador""tesorero""vicecontador""delegado_infantiles""delegado_1""delegado_2""delegado_3""delegado_4""delegado_5""delegado_6""delegado_7""bibliotecario_archivero""fallera_mayor""vocal""miembro_junta_local""directiva_agrupacion"

    • leftAtstring (date-time) | nullopcional
  • historyNoteLocalizedNoteDtoobligatori

    Aviso de que el historial puede no ser completo

    object

    • esstringobligatori
    • vastringobligatori
  • personIdstring (uuid)opcional

    Solo para la Junta (person:read): la persona global

  {
    "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
    "entity": {
      "id": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "kind": "comision",
      "officialNumber": "texto",
      "slug": "texto",
      "name": "texto"
    },
    "jcfCensusNumber": "texto",
    "givenName": "texto",
    "familyName": "texto",
    "birthDate": "2026-10-06",
    "sex": "hombre",
    "idKind": "dni",
    "nationalId": "texto",
    "reference": "texto",
    "address": "texto",
    "city": "texto",
    "postalCode": "texto",
    "phone1": "texto",
    "phone2": "texto",
    "email": "texto",
    "exercise": "2026-27",
    "entry": {
      "entryId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "profileId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
      "censusNumber": 0,
      "givenName": "texto",
      "familyName": "texto",
      "category": "infantil",
      "office": "presidente",
      "joinedAt": "2026-10-06T10:00:00.000Z",
      "leftAt": "2026-10-06T10:00:00.000Z",
      "leaveReason": "voluntaria",
      "leaveNote": "texto"
    },
    "awards": {
      "distintiuArgent": 0,
      "distintiuOr": 0,
      "bunyolArgent": 0,
      "bunyolOr": 0,
      "bunyolFulles": 0,
      "bunyolBrillants": 0
    },
    "history": [
      {
        "exercise": "2025-26",
        "entityOfficialNumber": "texto",
        "entityName": "texto",
        "category": "infantil",
        "censusNumber": 0,
        "office": "presidente",
        "leftAt": "2026-10-06T10:00:00.000Z"
      }
    ],
    "historyNote": {
      "es": "texto",
      "va": "texto"
    },
    "personId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 401ErrorBodyDtounauthorized: sin sesión, o con una clave o un token que no vale (cabecera WWW-Authenticate)

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 403ErrorBodyDtoforbidden: la cuenta ve el recurso pero no tiene la acción

  Model: ErrorBodyDto

  {
    "code": "forbidden",
    "message": "No tienes permiso para esta acción",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "campoDesconocido": [
        "whitelistValidation"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Paràmetres

• idstringcamíobligatori
• cursorstringconsultaopcional

  El nextCursor de la página anterior

• limitnumberconsultaopcional≤ 200≥ 1= 50
• exercisestringconsultaopcional

  Id o etiqueta del ejercicio («2026-27»); por defecto, el en curso

• filter"adults" | "children" | "all" | "left" | "everyone"consultaopcional= "all"

  adults = mayores activos · children = infantiles activos · all = todos activos · left = solo bajas · everyone = todos

• qstringconsultaopcional

  Nombre o apellidos (todas las palabras), o nº de censo en falla

Respostes

• 200CensusPageDto

  • exercisestringobligatori

    Exemple: "2026-27"

  • itemsCensusRowDto[]obligatori
    CensusRowDto

    • entryIdstring (uuid)obligatori
    • profileIdstring (uuid)obligatori
    • censusNumbernumber | nullopcional

      Nº de censo en falla

    • givenNamestringobligatori
    • familyNamestringobligatori
    • categorystringobligatori

      Valors:"infantil""mayor"

    • officestring | nullopcional

      Valors:"presidente""vicepresidente_1""vicepresidente_2""vicepresidente_3""vicepresidente_4""secretario""vicesecretario""contador""tesorero""vicecontador""delegado_infantiles""delegado_1""delegado_2""delegado_3""delegado_4""delegado_5""delegado_6""delegado_7""bibliotecario_archivero""fallera_mayor""vocal""miembro_junta_local""directiva_agrupacion"

    • joinedAtstring (date-time)obligatori
    • leftAtstring (date-time) | nullopcional
    • leaveReasonstring | nullopcional

      Valors:"voluntaria""traslado""fallecimiento""expulsion""otro"

    • leaveNotestring | nullopcional
  • nextCursorstring | nullopcional

  {
    "exercise": "2026-27",
    "items": [
      {
        "entryId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
        "profileId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
        "censusNumber": 0,
        "givenName": "texto",
        "familyName": "texto",
        "category": "infantil",
        "office": "presidente",
        "joinedAt": "2026-10-06T10:00:00.000Z",
        "leftAt": "2026-10-06T10:00:00.000Z",
        "leaveReason": "voluntaria",
        "leaveNote": "texto"
      }
    ],
    "nextCursor": "texto"
  }

• 401ErrorBodyDtounauthorized: sin sesión, o con una clave o un token que no vale (cabecera WWW-Authenticate)

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 403ErrorBodyDtoforbidden: la cuenta ve el recurso pero no tiene la acción

  Model: ErrorBodyDto

  {
    "code": "forbidden",
    "message": "No tienes permiso para esta acción",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "limit": [
        "max"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Paràmetres

• idstringcamíobligatori
• exercisestringconsultaopcional

  Id o etiqueta del ejercicio de la entrada; por defecto, el en curso

Respostes

• 200OfficesDto

  • exercisestringobligatori

    Exemple: "2026-27"

  • officesOfficeSlotDto[]obligatori

    Todos los cargos menos vocal, en el orden de OFFICE_RANK

    OfficeSlotDto

    • officestringobligatori

      Valors:"presidente""vicepresidente_1""vicepresidente_2""vicepresidente_3""vicepresidente_4""secretario""vicesecretario""contador""tesorero""vicecontador""delegado_infantiles""delegado_1""delegado_2""delegado_3""delegado_4""delegado_5""delegado_6""delegado_7""bibliotecario_archivero""fallera_mayor""vocal""miembro_junta_local""directiva_agrupacion"

    • uniquebooleanobligatori

      Cargo único (desplaza al anterior)

    • holdersOfficeHolderDto[]obligatori

      Ocupantes activos en el ejercicio (vacío = sin cubrir)

      OfficeHolderDto

      • profileIdstring (uuid)obligatori
      • givenNamestringobligatori
      • familyNamestringobligatori
      • categorystringobligatori

        Valors:"infantil""mayor"

      • censusNumbernumber | nullopcional
  • vocalCountnumberobligatori

    Personas activas con cargo vocal

  {
    "exercise": "2026-27",
    "offices": [
      {
        "office": "presidente",
        "unique": true,
        "holders": [
          {
            "profileId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b",
            "givenName": "texto",
            "familyName": "texto",
            "category": "infantil",
            "censusNumber": 0
          }
        ]
      }
    ],
    "vocalCount": 0
  }

• 401ErrorBodyDtounauthorized: sin sesión, o con una clave o un token que no vale (cabecera WWW-Authenticate)

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 403ErrorBodyDtoforbidden: la cuenta ve el recurso pero no tiene la acción

  Model: ErrorBodyDto

  {
    "code": "forbidden",
    "message": "No tienes permiso para esta acción",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "campoDesconocido": [
        "whitelistValidation"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: El fichero de un documento o de una comunicación se sirve por la audiencia del contenido VIVO que lo liga (publicado o enviada, no borrado): público sin sesión; de cuentas o con reglas, 401 sin sesión y 404 si no es para esa entidad; despublicado, borrador o borrado, solo la Junta (404). Los privados (registro, mensajes, expedientes) solo quien los subió, su entidad o la Junta.

Paràmetres

• idstringcamíobligatori

Respostes

• 200string (binary)Los bytes

  string (binary)

  "<fichero>"

• 401ErrorBodyDtounauthorized: el contenido es de nivel members y no hay sesión

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: El menú es navegación: solo lleva las páginas que la audiencia deja ver a la sesión; con sesión de entidad, el bloque «Zona Privada»; con la Junta, el enlace a Gestión JCF.

Respostes

• 200MenuDto

  • mainMenuItemDto[]obligatori

    Menú principal: las páginas que la audiencia deja ver a la sesión (navegación: lo que no puede abrir no sale)

    MenuItemDto

    • slugstringobligatori
    • pathstringobligatori
    • titleEsstringobligatori
    • titleVastringobligatori
    • childrenMenuItemDto[]obligatori
  • privateZonePrivateZoneItemDto[] | nullopcional

    Bloque «Zona Privada»: solo con sesión de una entidad

    PrivateZoneItemDto

    • keystringobligatori

      Valors:"summary""profile""entity""census""procedures""can_submit""exercise_start""awards""ffmm_request""ffmm_candidacies""messages""my_fallas""board_census""board_members"

    • pathstringobligatori
    • titleEsstringobligatori
    • titleVastringobligatori
    • childrenPrivateZoneItemDto[]obligatori

      Subentradas (las de «Trámites y servicios»)

  • gestionbooleanobligatori

    Con sesión de la Junta: enlace a Gestión JCF

  • privateZonePathsstring[]obligatori

    Rutas de la Zona Privada (con o sin sesión): una web sabe así que una ruta es privada y, sin sesión, manda al acceso. Solo rutas, ningún dato

  {
    "main": [
      {
        "slug": "texto",
        "path": "texto",
        "titleEs": "texto",
        "titleVa": "texto",
        "children": [
          {}
        ]
      }
    ],
    "privateZone": [
      {
        "key": "summary",
        "path": "texto",
        "titleEs": "texto",
        "titleVa": "texto",
        "children": [
          {}
        ]
      }
    ],
    "gestion": true,
    "privateZonePaths": [
      "texto"
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, lo `public` entero y lo demás cerrado (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, lo que la audiencia deja a SU entidad entero y lo demás con `reason: not_for_entity`. Lo `staff` nunca sale por aquí (solo por /gestion); lo `hidden` no se lista. Cada entrada trae `allowed`, `reason` y sus `actions`.

Paràmetres

• parentstringconsultaopcional

  Solo las hijas de esta página (p. ej. ayuda: el centro de ayuda)

• qstringconsultaopcional

  Busca en título y cuerpo, en castellano y valenciano (sin distinguir mayúsculas)

Respostes

• 200PageListDto

  • itemsPageDto[]obligatori
    PageDto

    • audienceAudienceDtoobligatori
      AudienceDto

      • modestringobligatori

        Valors:"public""authenticated""rules""staff"

      • rulesAudienceRuleDto[]opcional

        Solo con mode: rules

        AudienceRuleDto

        • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

          Valors:"comision""junta_local""falla_municipio""agrupacion"

        • sectorsstring[]opcional

          Sectores de València (los de las entidades)

        • localBoardsstring[]opcional

          Ids de juntas locales: casa la junta local y sus fallas de municipio

        • groupingsstring[]opcional

          Ids de agrupaciones: casa la agrupación y sus comisiones

        • entitiesstring[]opcional

          Ids de entidades concretas

        • citiesstring[]opcional

          Municipios

        • categoriesstring[]opcional

          Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

    • audienceLabelEsstringobligatori

      La frase de la ficha en castellano («Para: comisiones de València del sector X»)

    • audienceLabelVastringobligatori

      La frase en valenciano

    • allowedbooleanobligatori

      La sesión (o la credencial) puede abrirlo o presentarlo

    • reasonstring | nullopcional

      anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

      Valors:"anonymous""not_for_entity""closed"

    • idstringobligatori
    • slugstringobligatori
    • pathstringobligatori

      Ruta en la web de las fallas

    • kindstringobligatori

      Valors:"content""link"

    • titleEsstringobligatori
    • titleVastringobligatori
    • bodyEsstringobligatori

      Markdown; vacío si la página está cerrada (locked)

    • bodyVastringobligatori
    • hiddenbooleanobligatori

      No se lista (se abre por enlace directo si la audiencia lo permite)

    • lockedbooleanobligatori

      = !allowed: se enseña el título y el motivo, sin cuerpo

    • menustring | nullopcional
    • parentSlugstring | nullopcional
    • ordernumberobligatori
    • publishedAtstring | nullopcional
    • updatedAtstringobligatori
    • actions"view" | "download" | "sign_in_to_download" | "edit"[]obligatori

      Valors:"view""download""sign_in_to_download""edit"

  {
    "items": [
      {
        "audience": {
          "mode": "public",
          "rules": []
        },
        "audienceLabelEs": "texto",
        "audienceLabelVa": "texto",
        "allowed": true,
        "reason": "anonymous",
        "id": "texto",
        "slug": "texto",
        "path": "texto",
        "kind": "content",
        "titleEs": "texto",
        "titleVa": "texto",
        "bodyEs": "texto",
        "bodyVa": "texto",
        "hidden": true,
        "locked": true,
        "menu": "texto",
        "parentSlug": "texto",
        "order": 0,
        "publishedAt": "texto",
        "updatedAt": "texto",
        "actions": [
          "view"
        ]
      }
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "campoDesconocido": [
        "whitelistValidation"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, lo `public` entero y lo demás cerrado (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, lo que la audiencia deja a SU entidad entero y lo demás con `reason: not_for_entity`. Lo `staff` nunca sale por aquí (solo por /gestion); lo `hidden` no se lista. Cada entrada trae `allowed`, `reason` y sus `actions`.

Paràmetres

• slugstringcamíobligatori

Respostes

• 200PageDto

  • audienceAudienceDtoobligatori
    AudienceDto

    • modestringobligatori

      Valors:"public""authenticated""rules""staff"

    • rulesAudienceRuleDto[]opcional

      Solo con mode: rules

      AudienceRuleDto

      • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

        Valors:"comision""junta_local""falla_municipio""agrupacion"

      • sectorsstring[]opcional

        Sectores de València (los de las entidades)

      • localBoardsstring[]opcional

        Ids de juntas locales: casa la junta local y sus fallas de municipio

      • groupingsstring[]opcional

        Ids de agrupaciones: casa la agrupación y sus comisiones

      • entitiesstring[]opcional

        Ids de entidades concretas

      • citiesstring[]opcional

        Municipios

      • categoriesstring[]opcional

        Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

  • audienceLabelEsstringobligatori

    La frase de la ficha en castellano («Para: comisiones de València del sector X»)

  • audienceLabelVastringobligatori

    La frase en valenciano

  • allowedbooleanobligatori

    La sesión (o la credencial) puede abrirlo o presentarlo

  • reasonstring | nullopcional

    anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

    Valors:"anonymous""not_for_entity""closed"

  • idstringobligatori
  • slugstringobligatori
  • pathstringobligatori

    Ruta en la web de las fallas

  • kindstringobligatori

    Valors:"content""link"

  • titleEsstringobligatori
  • titleVastringobligatori
  • bodyEsstringobligatori

    Markdown; vacío si la página está cerrada (locked)

  • bodyVastringobligatori
  • hiddenbooleanobligatori

    No se lista (se abre por enlace directo si la audiencia lo permite)

  • lockedbooleanobligatori

    = !allowed: se enseña el título y el motivo, sin cuerpo

  • menustring | nullopcional
  • parentSlugstring | nullopcional
  • ordernumberobligatori
  • publishedAtstring | nullopcional
  • updatedAtstringobligatori
  • actions"view" | "download" | "sign_in_to_download" | "edit"[]obligatori

    Valors:"view""download""sign_in_to_download""edit"

  {
    "audience": {
      "mode": "public",
      "rules": [
        {
          "kinds": [],
          "sectors": [],
          "localBoards": [],
          "groupings": [],
          "entities": [],
          "cities": [],
          "categories": []
        }
      ]
    },
    "audienceLabelEs": "texto",
    "audienceLabelVa": "texto",
    "allowed": true,
    "reason": "anonymous",
    "id": "texto",
    "slug": "texto",
    "path": "texto",
    "kind": "content",
    "titleEs": "texto",
    "titleVa": "texto",
    "bodyEs": "texto",
    "bodyVa": "texto",
    "hidden": true,
    "locked": true,
    "menu": "texto",
    "parentSlug": "texto",
    "order": 0,
    "publishedAt": "texto",
    "updatedAt": "texto",
    "actions": [
      "view"
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, lo `public` entero y lo demás cerrado (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, lo que la audiencia deja a SU entidad entero y lo demás con `reason: not_for_entity`. Lo `staff` nunca sale por aquí (solo por /gestion); lo `hidden` no se lista. Cada entrada trae `allowed`, `reason` y sus `actions`.

Paràmetres

• cursorstringconsultaopcional

  El nextCursor de la página anterior

• limitnumberconsultaopcional≤ 200≥ 1= 50
• category"impresos_jcf" | "agrupaciones" | "juntas_locales" | "ayuntamiento" | "jornadas" | "privacidad" | "rgcre" | "petardos" | "normativa" | "otros"consultaopcional
• delegation"cultura_solidaridad" | "deportes" | "festejos" | "infantiles_juventud" | "juveniles" | "relaciones_publicas_protocolo" | "incidencias" | "fallas" | "pirotecnia" | "censos" | "recompensas" | "medios_comunicacion" | "secretaria" | "juntas_locales"consultaopcional
• pagestringconsultaopcional

  Solo los de esta subpágina

• qstringconsultaopcional

  Busca en el título (castellano y valenciano)

• kind"pdf" | "pdf_r" | "excel" | "word" | "zip" | "otro"consultaopcional

  Formato (PDF, PDF rellenable, Excel…)

• sectionstringconsultaopcional

  Sección dentro de la subpágina (el rótulo en castellano, p. ej. Censos)

• downloadable"true"consultaopcional

  Solo los que quien mira puede descargar ya (hay fichero y su nivel está abierto)

Respostes

• 200DocumentPageDto

  • itemsDocumentDto[]obligatori
    DocumentDto

    • audienceAudienceDtoobligatori
      AudienceDto

      • modestringobligatori

        Valors:"public""authenticated""rules""staff"

      • rulesAudienceRuleDto[]opcional

        Solo con mode: rules

        AudienceRuleDto

        • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

          Valors:"comision""junta_local""falla_municipio""agrupacion"

        • sectorsstring[]opcional

          Sectores de València (los de las entidades)

        • localBoardsstring[]opcional

          Ids de juntas locales: casa la junta local y sus fallas de municipio

        • groupingsstring[]opcional

          Ids de agrupaciones: casa la agrupación y sus comisiones

        • entitiesstring[]opcional

          Ids de entidades concretas

        • citiesstring[]opcional

          Municipios

        • categoriesstring[]opcional

          Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

    • audienceLabelEsstringobligatori

      La frase de la ficha en castellano («Para: comisiones de València del sector X»)

    • audienceLabelVastringobligatori

      La frase en valenciano

    • allowedbooleanobligatori

      La sesión (o la credencial) puede abrirlo o presentarlo

    • reasonstring | nullopcional

      anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

      Valors:"anonymous""not_for_entity""closed"

    • idstringobligatori
    • titleEsstringobligatori
    • titleVastringobligatori
    • categorystringobligatori

      Valors:"impresos_jcf""agrupaciones""juntas_locales""ayuntamiento""jornadas""privacidad""rgcre""petardos""normativa""otros"

    • pageSlugstring | nullopcional
    • delegationstring | nullopcional

      Valors:"cultura_solidaridad""deportes""festejos""infantiles_juventud""juveniles""relaciones_publicas_protocolo""incidencias""fallas""pirotecnia""censos""recompensas""medios_comunicacion""secretaria""juntas_locales"

    • sectionEsstring | nullopcional
    • sectionVastring | nullopcional
    • hiddenbooleanobligatori
    • kindstringobligatori

      Valors:"pdf""pdf_r""excel""word""zip""otro"

    • hasFilebooleanobligatori

      Hay fichero descargable

    • fileIdstring | nullopcional

      Solo en Gestión JCF (/gestion/documents): para descargar por /files/{id} cualquier audiencia

    • pendingFilebooleanobligatori

      Sembrado desde el inventario sin el fichero real: la Junta lo sube

    • lockedbooleanobligatori

      = !allowed

    • ordernumberobligatori
    • publishedAtstring | nullopcional
    • updatedAtstringobligatori
    • actions"view" | "download" | "sign_in_to_download" | "edit"[]obligatori

      Valors:"view""download""sign_in_to_download""edit"

  • nextCursorstring | nullopcional

  {
    "items": [
      {
        "audience": {
          "mode": "public",
          "rules": []
        },
        "audienceLabelEs": "texto",
        "audienceLabelVa": "texto",
        "allowed": true,
        "reason": "anonymous",
        "id": "texto",
        "titleEs": "texto",
        "titleVa": "texto",
        "category": "impresos_jcf",
        "pageSlug": "texto",
        "delegation": "cultura_solidaridad",
        "sectionEs": "texto",
        "sectionVa": "texto",
        "hidden": true,
        "kind": "pdf",
        "hasFile": true,
        "fileId": "texto",
        "pendingFile": true,
        "locked": true,
        "order": 0,
        "publishedAt": "texto",
        "updatedAt": "texto",
        "actions": [
          "view"
        ]
      }
    ],
    "nextCursor": "texto"
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "limit": [
        "max"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, lo `public` entero y lo demás cerrado (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, lo que la audiencia deja a SU entidad entero y lo demás con `reason: not_for_entity`. Lo `staff` nunca sale por aquí (solo por /gestion); lo `hidden` no se lista. Cada entrada trae `allowed`, `reason` y sus `actions`.

Paràmetres

• cursorstringconsultaopcional

  El nextCursor de la página anterior

• limitnumberconsultaopcional≤ 200≥ 1= 50
• category"impresos_jcf" | "agrupaciones" | "juntas_locales" | "ayuntamiento" | "jornadas" | "privacidad" | "rgcre" | "petardos" | "normativa" | "otros"consultaopcional
• delegation"cultura_solidaridad" | "deportes" | "festejos" | "infantiles_juventud" | "juveniles" | "relaciones_publicas_protocolo" | "incidencias" | "fallas" | "pirotecnia" | "censos" | "recompensas" | "medios_comunicacion" | "secretaria" | "juntas_locales"consultaopcional
• pagestringconsultaopcional

  Solo los de esta subpágina

• qstringconsultaopcional

  Busca en el título (castellano y valenciano)

• kind"pdf" | "pdf_r" | "excel" | "word" | "zip" | "otro"consultaopcional

  Formato (PDF, PDF rellenable, Excel…)

• sectionstringconsultaopcional

  Sección dentro de la subpágina (el rótulo en castellano, p. ej. Censos)

• downloadable"true"consultaopcional

  Solo los que quien mira puede descargar ya (hay fichero y su nivel está abierto)

Respostes

• 200DocumentFacetsDto

  • totalnumberobligatori

    Cuántos casan con TODOS los filtros

  • categoriesFacetValueDto[]obligatori
    FacetValueDto

    • valuestringobligatori

      Valor del filtro (enumeración o, en sections, el rótulo en castellano)

    • labelVastring | nullopcional

      Solo en sections: el rótulo en valenciano

    • countnumberobligatori

      Cuántos casan con este valor y los demás filtros

  • delegationsFacetValueDto[]obligatori
    FacetValueDto

    • valuestringobligatori

      Valor del filtro (enumeración o, en sections, el rótulo en castellano)

    • labelVastring | nullopcional

      Solo en sections: el rótulo en valenciano

    • countnumberobligatori

      Cuántos casan con este valor y los demás filtros

  • kindsFacetValueDto[]obligatori
    FacetValueDto

    • valuestringobligatori

      Valor del filtro (enumeración o, en sections, el rótulo en castellano)

    • labelVastring | nullopcional

      Solo en sections: el rótulo en valenciano

    • countnumberobligatori

      Cuántos casan con este valor y los demás filtros

  • sectionsFacetValueDto[]obligatori
    FacetValueDto

    • valuestringobligatori

      Valor del filtro (enumeración o, en sections, el rótulo en castellano)

    • labelVastring | nullopcional

      Solo en sections: el rótulo en valenciano

    • countnumberobligatori

      Cuántos casan con este valor y los demás filtros

  • downloadablenumberobligatori

    Cuántos se pueden descargar ya con los demás filtros

  {
    "total": 0,
    "categories": [
      {
        "value": "texto",
        "labelVa": "texto",
        "count": 0
      }
    ],
    "delegations": [
      {
        "value": "texto",
        "labelVa": "texto",
        "count": 0
      }
    ],
    "kinds": [
      {
        "value": "texto",
        "labelVa": "texto",
        "count": 0
      }
    ],
    "sections": [
      {
        "value": "texto",
        "labelVa": "texto",
        "count": 0
      }
    ],
    "downloadable": 0
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "limit": [
        "max"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, lo `public` entero y lo demás cerrado (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, lo que la audiencia deja a SU entidad entero y lo demás con `reason: not_for_entity`. Lo `staff` nunca sale por aquí (solo por /gestion); lo `hidden` no se lista. Cada entrada trae `allowed`, `reason` y sus `actions`.

Paràmetres

• idstringcamíobligatori

Respostes

• 200DocumentDto

  • audienceAudienceDtoobligatori
    AudienceDto

    • modestringobligatori

      Valors:"public""authenticated""rules""staff"

    • rulesAudienceRuleDto[]opcional

      Solo con mode: rules

      AudienceRuleDto

      • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

        Valors:"comision""junta_local""falla_municipio""agrupacion"

      • sectorsstring[]opcional

        Sectores de València (los de las entidades)

      • localBoardsstring[]opcional

        Ids de juntas locales: casa la junta local y sus fallas de municipio

      • groupingsstring[]opcional

        Ids de agrupaciones: casa la agrupación y sus comisiones

      • entitiesstring[]opcional

        Ids de entidades concretas

      • citiesstring[]opcional

        Municipios

      • categoriesstring[]opcional

        Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

  • audienceLabelEsstringobligatori

    La frase de la ficha en castellano («Para: comisiones de València del sector X»)

  • audienceLabelVastringobligatori

    La frase en valenciano

  • allowedbooleanobligatori

    La sesión (o la credencial) puede abrirlo o presentarlo

  • reasonstring | nullopcional

    anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

    Valors:"anonymous""not_for_entity""closed"

  • idstringobligatori
  • titleEsstringobligatori
  • titleVastringobligatori
  • categorystringobligatori

    Valors:"impresos_jcf""agrupaciones""juntas_locales""ayuntamiento""jornadas""privacidad""rgcre""petardos""normativa""otros"

  • pageSlugstring | nullopcional
  • delegationstring | nullopcional

    Valors:"cultura_solidaridad""deportes""festejos""infantiles_juventud""juveniles""relaciones_publicas_protocolo""incidencias""fallas""pirotecnia""censos""recompensas""medios_comunicacion""secretaria""juntas_locales"

  • sectionEsstring | nullopcional
  • sectionVastring | nullopcional
  • hiddenbooleanobligatori
  • kindstringobligatori

    Valors:"pdf""pdf_r""excel""word""zip""otro"

  • hasFilebooleanobligatori

    Hay fichero descargable

  • fileIdstring | nullopcional

    Solo en Gestión JCF (/gestion/documents): para descargar por /files/{id} cualquier audiencia

  • pendingFilebooleanobligatori

    Sembrado desde el inventario sin el fichero real: la Junta lo sube

  • lockedbooleanobligatori

    = !allowed

  • ordernumberobligatori
  • publishedAtstring | nullopcional
  • updatedAtstringobligatori
  • actions"view" | "download" | "sign_in_to_download" | "edit"[]obligatori

    Valors:"view""download""sign_in_to_download""edit"

  {
    "audience": {
      "mode": "public",
      "rules": [
        {
          "kinds": [],
          "sectors": [],
          "localBoards": [],
          "groupings": [],
          "entities": [],
          "cities": [],
          "categories": []
        }
      ]
    },
    "audienceLabelEs": "texto",
    "audienceLabelVa": "texto",
    "allowed": true,
    "reason": "anonymous",
    "id": "texto",
    "titleEs": "texto",
    "titleVa": "texto",
    "category": "impresos_jcf",
    "pageSlug": "texto",
    "delegation": "cultura_solidaridad",
    "sectionEs": "texto",
    "sectionVa": "texto",
    "hidden": true,
    "kind": "pdf",
    "hasFile": true,
    "fileId": "texto",
    "pendingFile": true,
    "locked": true,
    "order": 0,
    "publishedAt": "texto",
    "updatedAt": "texto",
    "actions": [
      "view"
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia no pública sin sesión → 401; con sesión y no es para su entidad → 403; si no, los bytes.

Paràmetres

• idstringcamíobligatori

Respostes

• 200string (binary)Los bytes

  string (binary)

  "<fichero>"

• 401ErrorBodyDtounauthorized: el contenido es de nivel members y no hay sesión

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Todo menos lo `staff` y lo `hidden`; lo que la sesión no puede ver sale sin descripción y con su motivo.

Paràmetres

• fromstringconsultaopcional

  Desde (ISO); por defecto, hoy

• tostringconsultaopcional

  Hasta (ISO); por defecto, un año después de from

• kind"junta" | "ffmm" | "otro"consultaopcional

Respostes

• 200EventListDto

  • itemsEventDto[]obligatori
    EventDto

    • audienceAudienceDtoobligatori
      AudienceDto

      • modestringobligatori

        Valors:"public""authenticated""rules""staff"

      • rulesAudienceRuleDto[]opcional

        Solo con mode: rules

        AudienceRuleDto

        • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

          Valors:"comision""junta_local""falla_municipio""agrupacion"

        • sectorsstring[]opcional

          Sectores de València (los de las entidades)

        • localBoardsstring[]opcional

          Ids de juntas locales: casa la junta local y sus fallas de municipio

        • groupingsstring[]opcional

          Ids de agrupaciones: casa la agrupación y sus comisiones

        • entitiesstring[]opcional

          Ids de entidades concretas

        • citiesstring[]opcional

          Municipios

        • categoriesstring[]opcional

          Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

    • audienceLabelEsstringobligatori

      La frase de la ficha en castellano («Para: comisiones de València del sector X»)

    • audienceLabelVastringobligatori

      La frase en valenciano

    • allowedbooleanobligatori

      La sesión (o la credencial) puede abrirlo o presentarlo

    • reasonstring | nullopcional

      anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

      Valors:"anonymous""not_for_entity""closed"

    • idstringobligatori
    • titleEsstringobligatori
    • titleVastringobligatori
    • descriptionEsstring | nullopcional

      Nula si la audiencia no lo deja ver

    • descriptionVastring | nullopcional
    • startsAtstringobligatori
    • endsAtstring | nullopcional
    • placestring | nullopcional
    • kindstringobligatori

      Valors:"junta""ffmm""otro"

    • hiddenbooleanobligatori
    • actions"view" | "download" | "sign_in_to_download" | "edit"[]obligatori

      Valors:"view""download""sign_in_to_download""edit"

  {
    "items": [
      {
        "audience": {
          "mode": "public",
          "rules": []
        },
        "audienceLabelEs": "texto",
        "audienceLabelVa": "texto",
        "allowed": true,
        "reason": "anonymous",
        "id": "texto",
        "titleEs": "texto",
        "titleVa": "texto",
        "descriptionEs": "texto",
        "descriptionVa": "texto",
        "startsAt": "texto",
        "endsAt": "texto",
        "place": "texto",
        "kind": "junta",
        "hidden": true,
        "actions": [
          "view"
        ]
      }
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "kind": [
        "isIn"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, las `public` enteras y las demás cerradas (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, las que su audiencia deja a SU entidad enteras y `read` por cuenta; las demás con `reason: not_for_entity`. Lo `staff` nunca; lo `hidden` no se lista.

Paràmetres

• cursorstringconsultaopcional

  El nextCursor de la página anterior

• limitnumberconsultaopcional≤ 200≥ 1= 50
• category"actas_asambleas_presidentes" | "actas_plenos" | "boletines" | "carteles_folletos" | "convocatorias_asambleas_presidentes" | "convocatorias_plenos" | "documentacion_asambleas_plenos" | "hojas_censos" | "instrucciones_bases" | "notas_avisos" | "solicitudes_inscripciones" | "varios" | "cursos_cre" | "otros"consultaopcional
• qstringconsultaopcional

  Busca en el título

• downloadable"true"consultaopcional

  Solo las que quien mira puede descargar ya (hay fichero y su nivel está abierto)

Respostes

• 200CommunicationPageDto

  • itemsCommunicationDto[]obligatori
    CommunicationDto

    • audienceAudienceDtoobligatori
      AudienceDto

      • modestringobligatori

        Valors:"public""authenticated""rules""staff"

      • rulesAudienceRuleDto[]opcional

        Solo con mode: rules

        AudienceRuleDto

        • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

          Valors:"comision""junta_local""falla_municipio""agrupacion"

        • sectorsstring[]opcional

          Sectores de València (los de las entidades)

        • localBoardsstring[]opcional

          Ids de juntas locales: casa la junta local y sus fallas de municipio

        • groupingsstring[]opcional

          Ids de agrupaciones: casa la agrupación y sus comisiones

        • entitiesstring[]opcional

          Ids de entidades concretas

        • citiesstring[]opcional

          Municipios

        • categoriesstring[]opcional

          Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

    • audienceLabelEsstringobligatori

      La frase de la ficha en castellano («Para: comisiones de València del sector X»)

    • audienceLabelVastringobligatori

      La frase en valenciano

    • allowedbooleanobligatori

      La sesión (o la credencial) puede abrirlo o presentarlo

    • reasonstring | nullopcional

      anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

      Valors:"anonymous""not_for_entity""closed"

    • idstringobligatori
    • categorystringobligatori

      Valors:"actas_asambleas_presidentes""actas_plenos""boletines""carteles_folletos""convocatorias_asambleas_presidentes""convocatorias_plenos""documentacion_asambleas_plenos""hojas_censos""instrucciones_bases""notas_avisos""solicitudes_inscripciones""varios""cursos_cre""otros"

    • titleEsstringobligatori
    • titleVastringobligatori
    • bodyEsstring | nullopcional

      Nulo si está cerrada (locked)

    • bodyVastring | nullopcional
    • hiddenbooleanobligatori
    • hasFilebooleanobligatori
    • pendingFilebooleanobligatori
    • lockedbooleanobligatori

      = !allowed

    • sentAtstring | nullopcional
    • readbooleanobligatori

      La cuenta de la sesión ya la ha abierto o descargado

    • actions"view" | "download" | "sign_in_to_download" | "edit"[]obligatori

      Valors:"view""download""sign_in_to_download""edit"

  • nextCursorstring | nullopcional

  {
    "items": [
      {
        "audience": {
          "mode": "public",
          "rules": []
        },
        "audienceLabelEs": "texto",
        "audienceLabelVa": "texto",
        "allowed": true,
        "reason": "anonymous",
        "id": "texto",
        "category": "actas_asambleas_presidentes",
        "titleEs": "texto",
        "titleVa": "texto",
        "bodyEs": "texto",
        "bodyVa": "texto",
        "hidden": true,
        "hasFile": true,
        "pendingFile": true,
        "locked": true,
        "sentAt": "texto",
        "read": true,
        "actions": [
          "view"
        ]
      }
    ],
    "nextCursor": "texto"
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "limit": [
        "max"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, las `public` enteras y las demás cerradas (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, las que su audiencia deja a SU entidad enteras y `read` por cuenta; las demás con `reason: not_for_entity`. Lo `staff` nunca; lo `hidden` no se lista.

Paràmetres

• cursorstringconsultaopcional

  El nextCursor de la página anterior

• limitnumberconsultaopcional≤ 200≥ 1= 50
• category"actas_asambleas_presidentes" | "actas_plenos" | "boletines" | "carteles_folletos" | "convocatorias_asambleas_presidentes" | "convocatorias_plenos" | "documentacion_asambleas_plenos" | "hojas_censos" | "instrucciones_bases" | "notas_avisos" | "solicitudes_inscripciones" | "varios" | "cursos_cre" | "otros"consultaopcional
• qstringconsultaopcional

  Busca en el título

• downloadable"true"consultaopcional

  Solo las que quien mira puede descargar ya (hay fichero y su nivel está abierto)

Respostes

• 200CommunicationFacetsDto

  • totalnumberobligatori

    Cuántas casan con TODOS los filtros

  • categoriesCommunicationFacetDto[]obligatori

    Categorías con cuántas casan contando los demás filtros

    CommunicationFacetDto

    • valuestringobligatori

      Valors:"actas_asambleas_presidentes""actas_plenos""boletines""carteles_folletos""convocatorias_asambleas_presidentes""convocatorias_plenos""documentacion_asambleas_plenos""hojas_censos""instrucciones_bases""notas_avisos""solicitudes_inscripciones""varios""cursos_cre""otros"

    • countnumberobligatori
  • downloadablenumberobligatori

    Cuántas se pueden descargar ya con los demás filtros

  {
    "total": 0,
    "categories": [
      {
        "value": "actas_asambleas_presidentes",
        "count": 0
      }
    ],
    "downloadable": 0
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "limit": [
        "max"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia (ADR 0016): sin sesión, las `public` enteras y las demás cerradas (título, frase de audiencia, `reason: anonymous`, `sign_in_to_download`); con sesión, las que su audiencia deja a SU entidad enteras y `read` por cuenta; las demás con `reason: not_for_entity`. Lo `staff` nunca; lo `hidden` no se lista. Abrirla con sesión deja la lectura de la cuenta.

Paràmetres

• idstringcamíobligatori

Respostes

• 200CommunicationDto

  • audienceAudienceDtoobligatori
    AudienceDto

    • modestringobligatori

      Valors:"public""authenticated""rules""staff"

    • rulesAudienceRuleDto[]opcional

      Solo con mode: rules

      AudienceRuleDto

      • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

        Valors:"comision""junta_local""falla_municipio""agrupacion"

      • sectorsstring[]opcional

        Sectores de València (los de las entidades)

      • localBoardsstring[]opcional

        Ids de juntas locales: casa la junta local y sus fallas de municipio

      • groupingsstring[]opcional

        Ids de agrupaciones: casa la agrupación y sus comisiones

      • entitiesstring[]opcional

        Ids de entidades concretas

      • citiesstring[]opcional

        Municipios

      • categoriesstring[]opcional

        Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

  • audienceLabelEsstringobligatori

    La frase de la ficha en castellano («Para: comisiones de València del sector X»)

  • audienceLabelVastringobligatori

    La frase en valenciano

  • allowedbooleanobligatori

    La sesión (o la credencial) puede abrirlo o presentarlo

  • reasonstring | nullopcional

    anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

    Valors:"anonymous""not_for_entity""closed"

  • idstringobligatori
  • categorystringobligatori

    Valors:"actas_asambleas_presidentes""actas_plenos""boletines""carteles_folletos""convocatorias_asambleas_presidentes""convocatorias_plenos""documentacion_asambleas_plenos""hojas_censos""instrucciones_bases""notas_avisos""solicitudes_inscripciones""varios""cursos_cre""otros"

  • titleEsstringobligatori
  • titleVastringobligatori
  • bodyEsstring | nullopcional

    Nulo si está cerrada (locked)

  • bodyVastring | nullopcional
  • hiddenbooleanobligatori
  • hasFilebooleanobligatori
  • pendingFilebooleanobligatori
  • lockedbooleanobligatori

    = !allowed

  • sentAtstring | nullopcional
  • readbooleanobligatori

    La cuenta de la sesión ya la ha abierto o descargado

  • actions"view" | "download" | "sign_in_to_download" | "edit"[]obligatori

    Valors:"view""download""sign_in_to_download""edit"

  {
    "audience": {
      "mode": "public",
      "rules": [
        {
          "kinds": [],
          "sectors": [],
          "localBoards": [],
          "groupings": [],
          "entities": [],
          "cities": [],
          "categories": []
        }
      ]
    },
    "audienceLabelEs": "texto",
    "audienceLabelVa": "texto",
    "allowed": true,
    "reason": "anonymous",
    "id": "texto",
    "category": "actas_asambleas_presidentes",
    "titleEs": "texto",
    "titleVa": "texto",
    "bodyEs": "texto",
    "bodyVa": "texto",
    "hidden": true,
    "hasFile": true,
    "pendingFile": true,
    "locked": true,
    "sentAt": "texto",
    "read": true,
    "actions": [
      "view"
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Audiencia no pública sin sesión → 401; no es para su entidad → 403; si no, los bytes (y la lectura queda apuntada).

Paràmetres

• idstringcamíobligatori

Respostes

• 200string (binary)Los bytes

  string (binary)

  "<fichero>"

• 401ErrorBodyDtounauthorized: el contenido es de nivel members y no hay sesión

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Respostes

• 200ContactDestinationListDto

  • itemsContactDestinationDto[]obligatori
    ContactDestinationDto

    • idstringobligatori
    • slugstringobligatori
    • nameEsstringobligatori
    • nameVastringobligatori
    • configuredbooleanobligatori

      Tiene correo configurado: si no, el mensaje se guarda y va al buzón general (o queda not_configured)

    • emailstring | nullopcional

      Correo público del destino (como la ficha de hoy); nulo si la Junta no lo ha puesto

    • phonestring | nullopcional

      Teléfono público; nulo si la Junta no lo ha puesto

    • descriptionEsstring | nullopcional

      Qué atiende (castellano); nulo = no se pinta

    • descriptionVastring | nullopcional
    • delegationstring | nullopcional

      Delegación de la Junta que atiende este destino (ola 5-F: el pie de Gestión y los correos que nacen de ella la buscan por aquí); nulo si no es una delegación

      Valors:"cultura_solidaridad""deportes""festejos""infantiles_juventud""juveniles""relaciones_publicas_protocolo""incidencias""fallas""pirotecnia""censos""recompensas""medios_comunicacion""secretaria""juntas_locales"

  {
    "items": [
      {
        "id": "texto",
        "slug": "texto",
        "nameEs": "texto",
        "nameVa": "texto",
        "configured": true,
        "email": "texto",
        "phone": "texto",
        "descriptionEs": "texto",
        "descriptionVa": "texto",
        "delegation": "cultura_solidaridad"
      }
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Con sesión, el mensaje queda ligado a la entidad activa (la delegación lo ve) y no hace falta ticket. SIN sesión y con Turnstile en el servidor, `publicTicket` es obligatorio (422 `required`); sin Turnstile, se acepta pero no se manda la copia al remitente.

Cos de la petició · application/json

{
  "delegation": "texto",
  "name": "texto",
  "email": "texto",
  "fallaNumber": "texto",
  "fallaName": "texto",
  "subject": "texto",
  "message": "texto",
  "locale": "es",
  "publicTicket": "texto"
}

Respostes

• 201ContactResultDto

  • idstringobligatori
  • referencestringobligatori

    Referencia corta para citar el mensaje (los 8 últimos caracteres del id, en mayúsculas)

  • createdAtstringobligatori
  • delegationMailstringobligatori

    Correo a la delegación: logged = sin proveedor (desarrollo); not_configured = el destino no tiene correo ni hay buzón general

    Valors:"pending""sent""logged""failed""not_configured""skipped_unverified"

  • copyMailstringobligatori

    Copia al remitente: skipped_unverified = sin sesión y sin Turnstile en el servidor no se manda un texto libre a un correo que nadie ha comprobado (sería un relé de phishing con remitente de la Junta); el mensaje queda guardado igual

    Valors:"pending""sent""logged""failed""not_configured""skipped_unverified"

  {
    "id": "texto",
    "reference": "texto",
    "createdAt": "texto",
    "delegationMail": "pending",
    "copyMail": "pending"
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "delegation": [
        "isString"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones (details.retryAfterSeconds, cabecera Retry-After)

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Respostes

• 200PublicSubmissionConfigDto

  • statusstringobligatori

    turnstile: hay captcha y el ticket es obligatorio sin sesión. quota_only: sin Turnstile en el servidor; se presenta igual (ticket opcional, solo necesario para adjuntar) con la mitad de la cuota por IP, y lo presentado queda verification: none

    Valors:"turnstile""quota_only"

  • siteKeystring | nullopcional

    Clave de sitio de Turnstile (pública) para el widget del navegador; nula en quota_only

  • ticketTtlSecondsnumberobligatori

    Validez del ticket, en segundos

  • quotaPerHournumberobligatori

    Presentaciones sin sesión por IP y hora que admite este servidor (PUBLIC_SUBMISSION_QUOTA_PER_HOUR; la mitad en quota_only)

  {
    "status": "turnstile",
    "siteKey": "texto",
    "ticketTtlSeconds": 0,
    "quotaPerHour": 0
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Cos de la petició · application/json

{
  "turnstileToken": "texto"
}

Respostes

• 201PublicTicketDto

  • ticketstringobligatori

    Ticket para UNA presentación sin sesión y sus adjuntos (cabecera o campo publicTicket)

  • expiresAtstringobligatori
  • verificationstringobligatori

    Cómo se comprobó que hay una persona: con el captcha o solo con la cuota (ADR 0025)

    Valors:"turnstile""none"

  {
    "ticket": "texto",
    "expiresAt": "texto",
    "verification": "turnstile"
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "turnstileToken": [
        "isString"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones (details.retryAfterSeconds, cabecera Retry-After)

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Cos de la petició · multipart/form-data

Respostes

• 201FileDto

  • idstringobligatori
  • typestringobligatori

    Valors:"pdf""jpg""png""docx""xlsx""zip""mp3"

  • mimeTypestringobligatori
  • sizenumberobligatori
  • originalNamestringobligatori
  • sha256stringobligatori

    SHA-256 del contenido (hex)

  • purposestringobligatori

    Valors:"document""communication""registry""message""receipt""procedure""candidacy""brand""award"

  • createdAtstringobligatori

  {
    "id": "texto",
    "type": "pdf",
    "mimeType": "texto",
    "size": 0,
    "originalName": "texto",
    "sha256": "texto",
    "purpose": "document",
    "createdAt": "texto"
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 413ErrorBodyDtopayload_too_large: el fichero pasa del máximo (details.maxBytes)

  Model: ErrorBodyDto

  {
    "code": "payload_too_large",
    "message": "Fichero demasiado grande",
    "details": {
      "maxBytes": 20971520
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "campo": [
        "whitelistValidation"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones (details.retryAfterSeconds, cabecera Retry-After)

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Igual con o sin sesión: es la identidad de la Junta.

Respostes

• 200OrganizationDto

  • officialNamestringobligatori

    Exemple: "Junta Central Fallera de València"

  • shortNamestringobligatori

    Exemple: "Junta Central Fallera"

  • legalFormEsstring | nullopcional
  • legalFormVastring | nullopcional
  • taxIdstring | nullopcional

    NIF

  • addressstring | nullopcional

    Dirección postal (puede tener saltos de línea)

  • phonestring | nullopcional
  • emailstring | nullopcional

    Correo general

  • websitestring | nullopcional
  • openingHoursEsstring | nullopcional
  • openingHoursVastring | nullopcional
  • dpoEmailstring | nullopcional

    Correo del Delegado de Protección de Datos

  • socialOrgSocialLinkDto[]obligatori
    OrgSocialLinkDto

    • labelstringobligatori

      Nombre de la red tal como se enseña (Instagram, Facebook…)

    • urlstringobligatori

      Enlace https

  • logoUrlstring | nullopcional

    Logo subido por la Junta (GET /org/logo); null = el provisional del kit

  • legalFooterEsstring | nullopcional

    Pie legal corto (castellano)

  • legalFooterVastring | nullopcional
  • updatedAtstringobligatori

  {
    "officialName": "Junta Central Fallera de València",
    "shortName": "Junta Central Fallera",
    "legalFormEs": "texto",
    "legalFormVa": "texto",
    "taxId": "texto",
    "address": "texto",
    "phone": "texto",
    "email": "texto",
    "website": "texto",
    "openingHoursEs": "texto",
    "openingHoursVa": "texto",
    "dpoEmail": "texto",
    "social": [
      {
        "label": "texto",
        "url": "texto"
      }
    ],
    "logoUrl": "texto",
    "legalFooterEs": "texto",
    "legalFooterVa": "texto",
    "updatedAt": "texto"
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: El logo es público.

Respostes

• 200string (binary)La imagen

  string (binary)

  "<fichero>"

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 404ErrorBodyDtonot_found: no existe o es de otra entidad (no se revela cuál)

  Model: ErrorBodyDto

  {
    "code": "not_found",
    "message": "No encontrado",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

Autenticació

Amb credencial, a més: Sin sesión: el catálogo entero (menos lo `staff` y lo `hidden`) con su audiencia escrita; `allowed: false` + `reason: anonymous` donde hace falta cuenta. Con sesión (o clave/token de la entidad): `allowed` y `reason` (`not_for_entity`, `closed`) para ESA entidad y el botón `do_online` si puede presentarlo.

Paràmetres

• delegation"cultura_solidaridad" | "deportes" | "festejos" | "infantiles_juventud" | "juveniles" | "relaciones_publicas_protocolo" | "incidencias" | "fallas" | "pirotecnia" | "censos" | "recompensas" | "medios_comunicacion" | "secretaria" | "juntas_locales"consultaopcional
• kind"online" | "pdf" | "document"consultaopcional

  Mejor channel

• channel"online" | "upload_signed" | "in_person" | "by_email" | "via_contact" | "external"consultaopcional
• qstringconsultaopcional

  Busca en el título y la descripción (castellano y valenciano, sin tildes)

Respostes

• 200ProcedureTypeListDto

  • itemsProcedureTypeDto[]obligatori
    ProcedureTypeDto

    • audienceAudienceDtoobligatori
      AudienceDto

      • modestringobligatori

        Valors:"public""authenticated""rules""staff"

      • rulesAudienceRuleDto[]opcional

        Solo con mode: rules

        AudienceRuleDto

        • kinds"comision" | "junta_local" | "falla_municipio" | "agrupacion"[]opcional

          Valors:"comision""junta_local""falla_municipio""agrupacion"

        • sectorsstring[]opcional

          Sectores de València (los de las entidades)

        • localBoardsstring[]opcional

          Ids de juntas locales: casa la junta local y sus fallas de municipio

        • groupingsstring[]opcional

          Ids de agrupaciones: casa la agrupación y sus comisiones

        • entitiesstring[]opcional

          Ids de entidades concretas

        • citiesstring[]opcional

          Municipios

        • categoriesstring[]opcional

          Reservado (categoría/sección de la falla): hoy no casa con ninguna entidad

    • audienceLabelEsstringobligatori

      La frase de la ficha en castellano («Para: comisiones de València del sector X»)

    • audienceLabelVastringobligatori

      La frase en valenciano

    • allowedbooleanobligatori

      La sesión (o la credencial) puede abrirlo o presentarlo

    • reasonstring | nullopcional

      anonymous accede; not_for_entity no es para tu entidad; closed fuera de plazo

      Valors:"anonymous""not_for_entity""closed"

    • idstringobligatori
    • slugstringobligatori
    • delegationstringobligatori

      Valors:"cultura_solidaridad""deportes""festejos""infantiles_juventud""juveniles""relaciones_publicas_protocolo""incidencias""fallas""pirotecnia""censos""recompensas""medios_comunicacion""secretaria""juntas_locales"

    • titleEsstringobligatori
    • titleVastringobligatori
    • descriptionEsstring | nullopcional
    • descriptionVastring | nullopcional
    • kindstringobligatori

      DERIVADO de channel (compatibilidad): online → online; upload_signed → pdf; el resto → document

      Valors:"online""pdf""document"

    • channelstringobligatori

      Cómo se presenta: online (formulario), upload_signed (descargar, firmar y subir por el propio trámite), in_person (oficina), by_email, via_contact (Contactar) o external (otra administración)

      Valors:"online""upload_signed""in_person""by_email""via_contact""external"

    • channelNoteEsstring | nullopcional

      Dónde, cómo y horario (castellano)

    • channelNoteVastring | nullopcional
    • hiddenbooleanobligatori
    • opensAtstring | nullopcional
    • closesAtstring | nullopcional
    • windowstringobligatori

      Plazo: sin plazo, abierto, aún no abierto o cerrado

      Valors:"always""open""not_yet""closed"

    • windowNoteEsstring | nullopcional
    • windowNoteVastring | nullopcional
    • documentIdstring | nullopcional

      Impreso de la biblioteca (GET /documents/{id}/file)

    • hasFormbooleanobligatori

      Tiene formulario publicado (se puede presentar en línea)

    • paymentPolicyPaymentPolicyDto | nullopcional

      Pago con justificante; nulo = sin pago

      object

      • amountCentsnumberobligatori

        Importe en céntimos (0 = según las bases de la convocatoria)

        Exemple: 13000

      • conceptstringobligatori

        Concepto que hay que poner en la transferencia o el ingreso

        Exemple: "Fianza Concurs de Playback"

      • ibanstring | nullopcional

        Cuenta (IBAN, sin espacios; se comprueba el control)

      • proofRequiredbooleanobligatori

        El expediente exige el justificante como anexo (role: payment_proof)

        Valors:true

      • noteEsstring | nullopcional

        Cómo pagar, en castellano (plazo, autoliquidación…)

      • noteVastring | nullopcional
    • sheetPendingReviewbooleanobligatori

      La ficha es un texto de partida pendiente de que la Junta lo revise

    • responsibleDelegationstring | nullopcional

      Valors:"cultura_solidaridad""deportes""festejos""infantiles_juventud""juveniles""relaciones_publicas_protocolo""incidencias""fallas""pirotecnia""censos""recompensas""medios_comunicacion""secretaria""juntas_locales"

    • ordernumberobligatori
    • actions"view" | "download" | "do_online" | "sign_in" | "do_anonymous" | "edit"[]obligatori

      Botones para ESTA sesión (los calcula la API)

      Valors:"view""download""do_online""sign_in""do_anonymous""edit"

  {
    "items": [
      {
        "audience": {
          "mode": "public",
          "rules": []
        },
        "audienceLabelEs": "texto",
        "audienceLabelVa": "texto",
        "allowed": true,
        "reason": "anonymous",
        "id": "texto",
        "slug": "texto",
        "delegation": "cultura_solidaridad",
        "titleEs": "texto",
        "titleVa": "texto",
        "descriptionEs": "texto",
        "descriptionVa": "texto",
        "kind": "online",
        "channel": "online",
        "channelNoteEs": "texto",
        "channelNoteVa": "texto",
        "hidden": true,
        "opensAt": "texto",
        "closesAt": "texto",
        "window": "always",
        "windowNoteEs": "texto",
        "windowNoteVa": "texto",
        "documentId": "texto",
        "hasForm": true,
        "paymentPolicy": {
          "amountCents": 13000,
          "concept": "Fianza Concurs de Playback",
          "iban": "texto",
          "proofRequired": true,
          "noteEs": "texto",
          "noteVa": "texto"
        },
        "sheetPendingReview": true,
        "responsibleDelegation": "cultura_solidaridad",
        "order": 0,
        "actions": [
          "view"
        ]
      }
    ]
  }

• 401ErrorBodyDtounauthorized: se mandó Authorization: Bearer con una clave o un token que no vale (cabecera WWW-Authenticate). Sin cabecera no se pide nada.

  Model: ErrorBodyDto

  {
    "code": "unauthorized",
    "message": "Hace falta iniciar sesión",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 422ErrorBodyDtovalidation: details lleva campo → problemas

  Model: ErrorBodyDto

  {
    "code": "validation",
    "message": "Datos no válidos",
    "details": {
      "delegation": [
        "isIn"
      ]
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 429ErrorBodyDtorate_limited: demasiadas peticiones con esta credencial (600/min); details.retryAfterSeconds y cabecera Retry-After

  Model: ErrorBodyDto

  {
    "code": "rate_limited",
    "message": "Demasiados intentos; espera un poco",
    "details": {
      "retryAfterSeconds": 42
    },
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }

• 500ErrorBodyDtointernal: error no controlado; da el requestId si nos escribes

  Model: ErrorBodyDto

  {
    "code": "internal",
    "message": "Error interno",
    "requestId": "0199b6a1-4c2e-7d3f-9a8b-1c2d3e4f5a6b"
  }