API REST Publica

Integra los datos de mascotas y registros medicos de Peludos en tu clinica veterinaria o aplicacion de terceros.

Autenticacion

Header X-API-Key con tu clave de API.

Rate limiting

Maximo 100 peticiones por minuto por API key.

CORS habilitado

Respuestas con headers CORS para integracion desde cualquier origen.

Autenticacion

Todas las peticiones requieren una API key en el header X-API-Key. Puedes generar tu API key desde Configuracion.

curl -H "X-API-Key: pk_tu_api_key_aqui" \
  https://peludos.ecosistia.com/api/v1/public/pets

Codigos de respuesta

Codigo	Significado
200	Peticion correcta
201	Recurso creado
400	Datos no validos
401	API key no proporcionada
403	API key no valida
404	Recurso no encontrado
429	Limite de peticiones excedido
500	Error interno del servidor

Endpoints

GET/api/v1/public/pets

Lista las mascotas del usuario autenticado.

Respuesta

{
  "pets": [
    {
      "id": "uuid",
      "name": "Luna",
      "species": "Perro",
      "breed": "Labrador",
      "microchip": "941000012345678",
      "dateOfBirth": "2020-03-15",
      "status": "active"
    }
  ]
}

GET/api/v1/public/pets/:petId

Detalle de una mascota con resumen de los ultimos 5 registros medicos.

Respuesta

{
  "pet": {
    "id": "uuid",
    "name": "Luna",
    "species": "Perro",
    "breed": "Labrador",
    "microchip": "941000012345678",
    "dateOfBirth": "2020-03-15",
    "gender": "female",
    "color": "dorado",
    "size": "large",
    "sterilized": true,
    "status": "active",
    "allergies": ["pollo"],
    "notes": null,
    "recentMedicalRecords": [
      {
        "id": "uuid",
        "type": "vaccination",
        "title": "Vacuna rabia",
        "date": "2025-06-01",
        "veterinarian": "Dr. Garcia",
        "clinic": "Clinica Veterinaria Sol"
      }
    ]
  }
}

GET/api/v1/public/pets/:petId/medical

Lista completa de registros medicos de una mascota.

Respuesta

{
  "medicalRecords": [
    {
      "id": "uuid",
      "type": "vaccination",
      "title": "Vacuna rabia",
      "description": "Vacunacion anual",
      "diagnosis": null,
      "treatment": null,
      "veterinarian": "Dr. Garcia",
      "clinic": "Clinica Veterinaria Sol",
      "date": "2025-06-01",
      "nextDate": "2026-06-01",
      "vaccinations": [
        {
          "vaccineName": "Rabia",
          "batchNumber": "RB-2025-001",
          "manufacturer": "Zoetis"
        }
      ]
    }
  ]
}

POST/api/v1/public/pets/:petId/medical

Crear un registro medico para una mascota. Ideal para clinicas veterinarias.

Request body

{
  "type": "checkup",
  "title": "Revision anual",
  "description": "Revision general completa",
  "diagnosis": "Buen estado de salud",
  "treatment": null,
  "veterinarian": "Dra. Lopez",
  "clinic": "Clinica Veterinaria Luna",
  "date": "2026-03-28",
  "nextDate": "2027-03-28"
}

Respuesta

{
  "medicalRecord": {
    "id": "uuid",
    "type": "checkup",
    "title": "Revision anual",
    "date": "2026-03-28",
    ...
  }
}

Base URL

https://peludos.ecosistia.com

Todas las respuestas son JSON. Las fechas usan formato ISO 8601 (YYYY-MM-DD). Los IDs son UUID v4.