API Dónde Ayudar Vzla

API REST con formato JSON:API para consultar lugares de acopio en Venezuela

Base URL

https://dondeayudarvzla.com/api/v1

Endpoints

GET/acopios

Obtiene todos los lugares de acopio aprobados.

Parámetros de filtro (opcionales)

Parámetro	Tipo	Descripción	Ejemplo
`filter[ciudad]`	string	Filtrar por ciudad (case-insensitive)	`?filter[ciudad]=Caracas`
`filter[tipo]`	string	punto_fijo, punto_movil, organizacion	`?filter[tipo]=organizacion`
`filter[estado_insumos]`	string	full, necesita	`?filter[estado_insumos]=necesita`
`filter[recurso]`	string	Filtrar por nombre de recurso que necesitan	`?filter[recurso]=agua`

Ejemplos de uso

curl

curl "https://dondeayudarvzla.com/api/v1/acopios?filter[ciudad]=Caracas&filter[estado_insumos]=necesita"

JavaScript (fetch)

const response = await fetch(
  "https://dondeayudarvzla.com/api/v1/acopios?filter[ciudad]=Caracas"
);
const data = await response.json();
console.log(data);

Python (requests)

import requests

response = requests.get(
    "https://dondeayudarvzla.com/api/v1/acopios",
    params={"filter[ciudad]": "Caracas"}
)
data = response.json()
print(data)

Schema de datos

Campo	Tipo	Descripción
`nombre`	string	Nombre del lugar de acopio
`tipo`	string	punto_fijo, punto_movil, organizacion
`direccion`	string	Dirección del lugar
`ciudad`	string	Ciudad donde se ubica
`estado`	string	Estado/región de Venezuela
`lat`	float \| null	Latitud para el mapa
`lng`	float \| null	Longitud para el mapa
`contacto`	string	Información de contacto
`horario`	string \| null	Horario de atención
`recursos`	object[]	Lista de recursos que necesitan (id, nombre, descripcion, categoria)
`estado_insumos`	string \| null	full (abastecido) o necesita
`foto_url`	string \| null	URL de la foto del lugar
`created_at`	string (ISO)	Fecha de creación

Formato de respuesta

La API sigue la especificación JSON:API 1.0.

{
  "data": [
    {
      "type": "acopios",
      "id": "uuid-del-lugar",
      "attributes": {
        "nombre": "Cruz Roja Venezolana",
        "tipo": "organizacion",
        "direccion": "Av. Andrés Bello, Caracas",
        "ciudad": "Caracas",
        "estado": "Distrito Capital",
        "lat": 10.4961,
        "lng": -66.85,
        "contacto": "(0212) 555-1234",
        "horario": "8am - 6pm",
        "recursos": [
          { "id": "uuid-recurso-1", "nombre": "Medicinas", "descripcion": null, "categoria": "medico" },
          { "id": "uuid-recurso-2", "nombre": "Voluntarios", "descripcion": null, "categoria": "otro" }
        ],
        "estado_insumos": "necesita",
        "foto_url": null,
        "created_at": "2026-06-26T00:00:00Z"
      }
    }
  ],
  "meta": {
    "total": 1
  },
  "jsonapi": {
    "version": "1.0"
  }
}

Notas

Paginación no implementada aún (volumen de datos actual < 100 registros).
Todos los endpoints son públicos y no requieren autenticación.
Los datos se actualizan en tiempo real a medida que los administradores aprueban reportes.