Mostrar sus animales en su propio sitio web (servicio web)

CriadorProtectora

¿Ya tiene un sitio web para su criadero o su protectora y quiere presentar en él sus animales sin introducirlos dos veces? El servicio web de animales es una dirección web que devuelve la información pública de sus animales en formato JSON, un formato que los sitios web pueden leer. Su sitio la lee en cada visita y la muestra como usted quiera: usted actualiza sus animales en la aplicación y su sitio se actualiza solo.

Está disponible para los espacios Criador y Protectora. Si su protectora también ofrece residencia, solo se comparten los animales de la protectora: los animales que le confían sus clientes de la residencia nunca se comparten. Un espacio solo de residencia no tiene animales que compartir.

Activar el servicio web

  1. Abra el menú lateral, sección Organización > Ajustes.
  2. Toque la línea Página pública y sitio.
  3. En la tarjeta Tus animales en tu propio sitio web, active Permitir el servicio web de animales.

El ajuste se guarda al instante: la dirección del servicio web aparece con el botón Copiar la dirección, seguida de un ejemplo listo para pegar en una página de su sitio y del botón Copiar el ejemplo. Transmita uno u otro a la persona que se ocupa de su sitio.

El servicio web está desactivado por defecto. Es independiente de su sitio web de Son espace santé: funciona incluso si este está desactivado (los enlaces a sus páginas públicas quedan entonces vacíos).

Vea también Página pública y sitio web: si no tiene sitio web, el que ofrece Son espace santé ya presenta sus animales, sin ningún código.

Lo que se comparte, y lo que nunca

El servicio web solo comparte lo que un visitante ya ve en su página pública.

ParaInformación compartida
Todos los animalesNombre, especie, raza, sexo, fecha de nacimiento, descripción, foto principal, último peso, inscripción LOF y confirmación, pruebas genéticas. Una galería de fotos extraída de las publicaciones públicas del diario del animal (12 fotos como máximo por animal).
CriadorDisponibilidad del semental y condiciones de monta (solo si el semental está indicado como disponible). Las camadas en curso, con sus cachorros y su estado (disponible, reservado, vendido).
ProtectoraEstado (en adopción, en casa de acogida, reservado), categoría, historia, carácter, compatibilidad con otros animales y con niños, perfil de adoptante ideal, mordeduras y uso de bozal.
Nunca se comparten: número de microchip, pasaporte, salud, identidad de la casa de acogida, ubicación en la protectora, comentarios internos, etiquetas, publicaciones del diario que no son públicas.

Tampoco figuran en la lista: los animales ocultos o archivados y, en una protectora, los animales en cuarentena o no visibles en la página pública.

Para su webmaster

Esta parte está dirigida a la persona que crea su sitio web.

La dirección

La aplicación muestra la dirección exacta de su servicio web. Tiene la forma https://server.sonespacesante.com/fr/organization/ws_public/<ID>/PublicAnimals/, donde <ID> es el número de su organización. Sustituya fr por en, de, it, es o pt para obtener los nombres de especie en otro idioma.

Parámetros opcionales, que se añaden tras la dirección (?species=…&litters=all):

  • species=<code>: solo los animales de una especie, indicada por su código (el campo species.code de la respuesta).
  • litters=all: incluye también las camadas terminadas; por defecto, solo se devuelven las camadas en curso.
  • lang=<code>: idioma de los nombres de especie, en lugar del de la dirección.

Uso

  • La dirección se llama directamente desde el navegador de los visitantes, desde cualquier sitio: sin clave, sin inicio de sesión y sin servidor intermedio.
  • Las respuestas se guardan en caché 5 minutos: un cambio hecho en la aplicación puede tardar hasta 5 minutos en aparecer.
  • Cada visitante está limitado a 90 llamadas por minuto, más que suficiente para una visualización normal.
  • Si el servicio web no está activado, la dirección responde con un error 403 y el código PublicApiDisabled. Si la organización no existe, responde con un error 404 y el código OrganizationNotFound.
  • Las direcciones de las fotos (photo, photos[].url) son estables y redirigen a la imagen: utilícelas tal cual en <img src>. No copie la dirección a la que redirigen: caduca al cabo de una hora.

Ejemplo de respuesta

Respuesta abreviada, para un criadero:

{
  "success": true, "version": 1, "generatedAt": "2026-10-04T13:00:00Z",
  "organization": {"id": 12, "name": "…", "types": ["breeder"], "logo": "https://…",
                   "city": "Lyon", "publicUrl": "https://apps.sonespacesante.com/elevage/…-12"},
  "count": 1,
  "animals": [{
    "id": 345, "activity": "breeder", "name": "Rex",
    "species": {"code": "…", "name": "Chien"}, "race": "Berger australien",
    "gender": "m", "birthday": "2022-01-01", "isDead": false, "description": "…",
    "photo": "https://…", "photos": [{"url": "https://…", "date": "2026-09-01"}],
    "weight": {"value": 24.5, "unit": "kg", "date": "2026-09-01"},
    "publicUrl": "https://…/345", "isLOF": true, "isConfirmed": true, "geneticTests": "",
    "breeder": {"isStud": true, "stud": {"fee": 800, "terms": "…"}}
  }],
  "litters": [{
    "id": 8, "name": "Rex x Luna 2026", "year": 2026, "matingDate": "2026-07-01",
    "birthDate": null, "expectedBirthDate": "2026-09-02", "description": "…", "isClosed": false,
    "father": {"id": 345, "name": "Rex", "race": "…", "photo": "https://…"},
    "mother": {…},
    "counts": {"total": 6, "available": 3, "reserved": 2, "sold": 1},
    "puppies": [{"id": 901, "name": "Bleu", "gender": "m", "birthday": "2026-09-02", "race": "…",
                 "color": "#3366ff", "photo": "https://…", "photos": [], "status": "available"}]
  }]
}

En una protectora, cada animal lleva un bloque refuge en lugar del bloque breeder:

"refuge": {
  "status": "ADOPTABLE" | "FOSTER" | "RESERVED" | null, "statusSince": "…",
  "adoptionAvailable": true, "category": {"name": "…", "color": "…"} | null,
  "history": "…", "character": "…", "agreements": "…", "adoptingProfile": "…",
  "biting": false, "muzzle": false
}

El estado de un cachorro (status) vale available (disponible), reserved (reservado) o sold (vendido). El de un animal de protectora vale ADOPTABLE (en adopción), FOSTER (en casa de acogida) o RESERVED (reservado).

Ejemplo de visualización

Es el ejemplo que ofrece el botón Copiar el ejemplo: muestra la foto, el nombre y la descripción de cada animal. Sustituya la dirección por la suya.

<div id="animals"></div>
<script>
fetch('https://server.sonespacesante.com/fr/organization/ws_public/<ID>/PublicAnimals/')
  .then(r => r.json())
  .then(data => {
    const list = document.getElementById('animals');
    data.animals.forEach(a => {
      const card = document.createElement('div');
      if (a.photo) {
        const img = document.createElement('img');
        img.src = a.photo; img.alt = a.name; img.width = 200;
        card.appendChild(img);
      }
      const name = document.createElement('h3');
      name.textContent = a.name;
      const text = document.createElement('p');
      text.textContent = a.description;
      card.append(name, text);
      list.appendChild(card);
    });
  });
</script>

Los textos se insertan con textContent, nunca con innerHTML: es la buena práctica para mostrar sin riesgo textos que vienen de otra fuente.

Preguntas frecuentes

He modificado un animal, pero mi sitio sigue mostrando la versión anterior.

La información se guarda en memoria 5 minutos: espere unos minutos y vuelva a cargar la página de su sitio.

¿Cómo dejar de compartir?

Desactive Permitir el servicio web de animales en Ajustes > Página pública y sitio (el cambio se guarda al instante). La dirección deja de devolver sus animales como máximo 5 minutos después.

¿Puedo no mostrar un animal concreto?

Sí: ocúltelo o archívelo. En una protectora, también puede desmarcar su visibilidad en la página pública desde su ficha.