Mostrar os seus animais no seu próprio site (serviço web)

Já tem um site para o seu criadouro ou o seu abrigo e quer apresentar nele os seus animais sem os introduzir duas vezes? O serviço web dos animais é um endereço web que devolve as informações públicas dos seus animais em formato JSON, um formato legível pelos sites. O seu site lê-as em cada visita e mostra-as como preferir: atualiza os seus animais na aplicação e o seu site acompanha automaticamente.

Está disponível para os espaços Criador e Abrigo. Se o seu abrigo também tiver um hotel para animais, só são partilhados os animais do abrigo: os animais confiados pelos clientes do hotel nunca são partilhados. Um espaço apenas de hotel para animais não tem animais para partilhar.

Ativar o serviço web

1. Abra o menu lateral, secção Organização > Definições.
2. Toque na linha Página pública e site.
3. No cartão Os seus animais no seu próprio site, ative Permitir o serviço web dos animais.

A definição é guardada de imediato: o endereço do serviço web aparece com o botão Copiar o endereço, seguido de um exemplo pronto a colar numa página do seu site e do botão Copiar o exemplo. Transmita um ou outro à pessoa que trata do seu site.

O serviço web está desativado por predefinição. É independente do seu site Son Espace Santé: funciona mesmo que este esteja desativado (as ligações para as suas páginas públicas ficam então vazias).

O que é partilhado, e o que nunca é

O serviço web só partilha o que um visitante já vê na sua página pública.

Também não constam da lista: os animais ocultos ou arquivados e, num abrigo, os animais em quarentena ou não visíveis na página pública.

Para o seu webmaster

Esta parte destina-se à pessoa que faz o seu site.

O endereço

A aplicação mostra o endereço exato do seu serviço web. Tem a forma https://server.sonespacesante.com/fr/organization/ws_public/<ID>/PublicAnimals/, em que <ID> é o número da sua organização. Substitua fr por en, de, it, es ou pt para obter os nomes das espécies noutra língua.

Parâmetros opcionais, a acrescentar a seguir ao endereço (?species=…&litters=all):

• species=<code>: apenas os animais de uma espécie, indicada pelo seu código (o campo species.code da resposta).
• litters=all: inclui também as ninhadas terminadas; por predefinição, só são devolvidas as ninhadas em curso.
• lang=<code>: língua dos nomes das espécies, em vez da do endereço.

Utilização

• O endereço é chamado diretamente a partir do navegador dos visitantes, a partir de qualquer site: sem chave, sem início de sessão, sem servidor intermédio.
• As respostas ficam em cache durante 5 minutos: uma alteração feita na aplicação pode demorar até 5 minutos a aparecer.
• Cada visitante está limitado a 90 chamadas por minuto, o que chega perfeitamente para uma apresentação normal.
• Se o serviço web não estiver ativado, o endereço responde com um erro 403 e o código PublicApiDisabled. Se a organização não existir, responde com um erro 404 e o código OrganizationNotFound.
• Os endereços das fotos (photo, photos[].url) são estáveis e redirecionam para a imagem: utilize-os tal como estão em <img src>. Não copie o endereço para o qual redirecionam: expira ao fim de uma hora.

Exemplo de resposta

Resposta abreviada, para um criadouro:

{
  "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"}]
  }]
}

Num abrigo, cada animal tem um bloco refuge em vez do bloco breeder:

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

O estado de uma cria (status) é available (disponível), reserved (reservado) ou sold (vendido). O de um animal de abrigo é ADOPTABLE (para adoção), FOSTER (em família de acolhimento) ou RESERVED (reservado).

Exemplo de apresentação

É o exemplo proposto pelo botão Copiar o exemplo: mostra a foto, o nome e a descrição de cada animal. Substitua o endereço pelo seu.

<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>

Os textos são inseridos com textContent, nunca com innerHTML: é a boa prática para mostrar sem risco textos vindos de outras fontes.

Perguntas frequentes

Alterei um animal, mas o meu site ainda mostra a versão antiga.

As informações ficam guardadas em memória durante 5 minutos: aguarde alguns minutos e depois recarregue a página do seu site.

Como deixar de partilhar?

Desative Permitir o serviço web dos animais em Definições > Página pública e site (a alteração é guardada de imediato). O endereço deixa de devolver os seus animais, no máximo 5 minutos depois.

Posso não mostrar um animal em particular?

Sim: oculte-o ou arquive-o. Num abrigo, também pode desmarcar a sua visibilidade na página pública na respetiva ficha.