Widget de Rescatados | PetFi Developers

code PetFi Developers

Widget de Rescatados

Incrusta todos los rescatados en adopción de PetFi en tu sitio web, con filtros por especie, región, comuna y tamaño.

key

Paso 0: consigue tu token

Este widget muestra el catálogo completo de PetFi, por lo que requiere un token de acceso gratuito. Escríbenos a contacto@petfi.io con el nombre de tu organización, la URL de tu sitio y el uso que le darás.

info

Para probar sin token usa demo: todos los ejemplos de esta página funcionan con él, limitado a 6 mascotas.

rocket_launch

Inicio rápido

Copia y pega este código en tu sitio web. Reemplaza TU_TOKEN por el token que te enviamos.

<div id="petfi-rescatados"></div>
<script src="https://petfi.io/widgets/rescues-widget.js"></script>
<script>
  PetFiRescuesWidget.init({
    target: "#petfi-rescatados",
    token: "TU_TOKEN"
  });
</script>

Eso es todo: el widget carga los rescatados publicados, muestra filtros de especie, región y tamaño, y cada tarjeta enlaza al perfil de la mascota en petfi.io.

crop_free

Alternativa: iframe

¿Tu plataforma no permite scripts (Wix, Squarespace, algunos WordPress)? Usa el iframe embebible — acepta los mismos filtros por parámetros en la URL:

<iframe
  src="https://petfi.io/widget/rescatados?token=TU_TOKEN"
  width="100%" height="900"
  style="border:0;border-radius:12px"
  loading="lazy"
  title="Rescatados en adopción - PetFi"></iframe>

tune

Parámetros

Los mismos nombres sirven para el script (opciones de init) y para la URL del iframe o la API.

Parámetro Tipo Default Descripción

token string requerido Tu token de acceso

species string todas Filtro inicial: "dog"/"perro" o "cat"/"gato"

region string todas Región de Chile, ej: "metropolitana", "valparaiso", "biobio"

comuna string todas Comuna, ej: "santiago", "vina-del-mar"

size string todos Tamaño: "pequeno", "mediano" o "grande"

limit number 24 Mascotas por página (máx 100)

showFilters boolean true Muestra los filtros interactivos (en iframe: filtros=0 para ocultarlos)

target string #petfi-rescatados Solo script: selector CSS del contenedor

code

Ejemplos

Solo perros de la Región Metropolitana

PetFiRescuesWidget.init({
  target: "#petfi-rescatados",
  token: "TU_TOKEN",
  species: "perro",
  region: "metropolitana"
});

Gatos pequeños, sin filtros visibles, 12 por página

PetFiRescuesWidget.init({
  target: "#petfi-rescatados",
  token: "TU_TOKEN",
  species: "gato",
  size: "pequeno",
  limit: 12,
  showFilters: false
});

Iframe filtrado a perros de Valparaíso

<iframe
  src="https://petfi.io/widget/rescatados?token=TU_TOKEN&especie=perro&region=valparaiso"
  width="100%" height="900" style="border:0"
  loading="lazy" title="Perros en adopción - PetFi"></iframe>

api

API REST

Si prefieres construir tu propia UI, consume el endpoint directamente. Requiere el mismo token (por query param o header X-PetFi-Token).

GET https://petfi.io/api/rescues?token=TU_TOKEN

Query params:
  token    string  requerido (o header X-PetFi-Token)
  species  "dog" | "cat" | "perro" | "gato"
  region   ej: "metropolitana", "valparaiso"
  comuna   ej: "santiago", "concepcion"
  size     "pequeno" | "mediano" | "grande"
  limit    número (default 24, max 100)
  offset   número (default 0, para paginar)

Rate limit: 120 solicitudes/min por IP → HTTP 429
con header Retry-After si te excedes.

Respuesta 200:

{
  "items": [
    {
      "id": "abc123",
      "name": "Luna",
      "species": "dog",
      "breed": "Mestizo",
      "photoUrl": "https://...",
      "slug": "luna-abc123",
      "url": "https://petfi.io/rescatado/luna-abc123",
      "city": "Santiago",
      "region": "Metropolitana",
      "age": "2 años",
      "size": "Mediano",
      "tags": ["Juguetón", "Sociable"],
      "daysWaiting": 45,
      "isNew": false,
      "foundationId": "xyz",
      "foundationName": "Fundación Patitas"
    }
  ],
  "count": 24,
  "total": 312,
  "offset": 0,
  "limit": 24
}

Respuesta 401 (token inválido o ausente):

{
  "error": "invalid_token",
  "message": "Solicita tu token de acceso escribiendo a contacto@petfi.io"
}

info

¿Solo necesitas las mascotas de TU fundación? Ese endpoint no requiere token: revisa el widget para fundaciones.

auto_awesome

Características

filter_alt

Filtros integrados

Especie, región, comuna y tamaño — interactivos dentro del widget o fijados por parámetros

shield

Estilos aislados

Shadow DOM evita conflictos con los estilos de tu sitio

devices

Responsive

Se adapta automáticamente a cualquier ancho de pantalla

touch_app

Interactivo

Cards clickeables, botón "Cargar más" y enlace al perfil completo en PetFi

speed

Rápido

Datos cacheados en servidor, carga en menos de 1 segundo

money_off

Gratis

Sin costo — solo pedimos atribución visible a PetFi

¿Necesitas ayuda? Escríbenos a contacto@petfi.io o por Instagram @petfiapp