API · Documentación

Esta API es de solo lectura y sirve para consumir los reportes públicos del mapa. Si necesitas acceso de escritura, escríbenos a mapsoscuba@proton.me.

Base URL: https://soscuba.us/api/v1

Autenticación

No se requiere autenticación para lectura pública.

Endpoint principal

GET

/api/v1/reports

Lista paginada de reportes aprobados.

page (opcional) · número de página. Default: 1.

per_page (opcional) · items por página. Default: 50 (máx. 100).

category_id (opcional) · filtra por categoría.

province (opcional) · filtra por provincia.

municipality (opcional) · filtra por municipio.

GET https://soscuba.us/api/v1/reports?per_page=25&province=La%20Habana

{
  "page": 1,
  "per_page": 25,
  "total": 120,
  "pages": 5,
  "has_next": true,
  "has_prev": false,
  "items": [
    {
      "id": 123,
      "title": "UM 2104",
      "description": "...",
      "latitude": 21.10,
      "longitude": -76.13,
      "address": "...",
      "province": "La Habana",
      "municipality": "Playa",
      "movement_at": "2026-03-04T18:30:00Z",
      "repressor_name": "",
      "other_type": "",
      "status": "approved",
      "polygon_geojson": null,
      "links": ["https://..."],
      "media": [{"url": "https://...", "caption": "..."}],
      "verify_count": 3,
      "created_at": "2026-03-04T00:00:00Z",
      "updated_at": "2026-03-04T00:00:00Z",
      "category": {"id": 4, "name": "Unidad militar", "slug": "unidad-militar"},
      "anon": "Anon-ABC123"
    }
  ]
}

Detalle de reporte

GET

/api/v1/reports/<id>

Devuelve un reporte específico por su ID.

GET https://soscuba.us/api/v1/reports/123

Categorías

GET

/api/v1/categories

Lista de categorías disponibles.

Catálogo de represores

GET

/api/v1/repressors

Lista paginada de represores sincronizados en base de datos local.

q (opcional) · busca por nombre/apodo/institución/ID.

province (opcional) · filtra por provincia.

municipality (opcional) · filtra por municipio.

page / per_page para paginación.

POST

/api/v1/repressors/<id>/residence-reports

Crea reporte de vivienda y genera post categoría residencia-represor.

Notas

Solo se exponen reportes con estado approved.
Si necesitas endpoints de escritura, contáctanos en mapsoscuba@proton.me.