Ihre Tiere auf Ihrer eigenen Website anzeigen (Webservice)

ZüchterTierheim

Sie haben bereits eine Website für Ihre Zucht oder Ihr Tierheim und möchten dort Ihre Tiere zeigen, ohne sie doppelt zu erfassen? Der Webservice für Tiere ist eine Webadresse, die die öffentlichen Informationen Ihrer Tiere im JSON-Format liefert, einem Format, das Websites lesen können. Ihre Website liest sie bei jedem Besuch und zeigt sie so an, wie Sie es möchten: Sie pflegen Ihre Tiere in der App, und Ihre Website zieht automatisch nach.

Er steht für die Bereiche Züchter und Tierheim zur Verfügung. Bietet Ihr Tierheim auch eine Tierpension an, werden nur die Tiere des Tierheims geteilt: Die Tiere Ihrer Pensionskunden werden nie geteilt. Ein reiner Tierpension-Bereich hat keine Tiere zu teilen.

Den Webservice aktivieren

Öffnen Sie das Seitenmenü, Rubrik Organisation > Einstellungen.
Tippen Sie auf die Zeile Öffentliche Seite und Website.
Aktivieren Sie in der Karte Ihre Tiere auf Ihrer eigenen Website die Option Webservice für Tiere erlauben.

Die Einstellung wird sofort gespeichert: Die Adresse des Webservice erscheint mit der Schaltfläche Adresse kopieren, gefolgt von einem Beispiel zum Einfügen in eine Seite Ihrer Website und der Schaltfläche Beispiel kopieren. Geben Sie das eine oder das andere an die Person weiter, die sich um Ihre Website kümmert.

Der Webservice ist standardmäßig deaktiviert. Er ist unabhängig von Ihrer Son espace santé-Website: Er funktioniert auch, wenn diese deaktiviert ist (die Links zu Ihren öffentlichen Seiten sind dann leer).

Siehe auch Öffentliche Seite und Website: Wenn Sie keine eigene Website haben, zeigt die von Son espace santé bereitgestellte Website Ihre Tiere bereits an, ganz ohne Code.

Was geteilt wird und was nie

Der Webservice teilt nur, was ein Besucher bereits auf Ihrer öffentlichen Seite sieht.

Für	Geteilte Informationen
Alle Tiere	Name, Tierart, Rasse, Geschlecht, Geburtsdatum, Beschreibung, Hauptfoto, letztes Gewicht, LOF-Eintragung und Bestätigung, Gentests. Eine Fotogalerie aus den öffentlichen Beiträgen im Tagebuch des Tieres (höchstens 12 Fotos pro Tier).
Züchter	Verfügbarkeit als Deckrüde bzw. Deckkater und Deckbedingungen (nur wenn das Tier als verfügbar markiert ist). Laufende Würfe mit ihren Welpen und deren Status (verfügbar, reserviert, verkauft).
Tierheim	Status (zur Vermittlung, in einer Pflegestelle, reserviert), Kategorie, Geschichte, Charakter, Verträglichkeit mit anderen Tieren und Kindern, ideales Adoptantenprofil, Beißverhalten und Maulkorb.

Nie geteilt: Mikrochipnummer, Heimtierausweis, Gesundheit, Identität der Pflegestelle, Standort im Tierheim, interne Kommentare, Etiketten, nicht öffentliche Tagebuchbeiträge.

Ebenfalls nicht in der Liste: ausgeblendete oder archivierte Tiere und bei einem Tierheim Tiere in Quarantäne oder solche, die auf der öffentlichen Seite nicht sichtbar sind.

Für Ihren Webmaster

Dieser Teil richtet sich an die Person, die Ihre Website erstellt.

Die Adresse

Die App zeigt die genaue Adresse Ihres Webservice an. Sie hat die Form https://server.sonespacesante.com/fr/organization/ws_public/<ID>/PublicAnimals/, wobei <ID> die Nummer Ihrer Organisation ist. Ersetzen Sie fr durch en, de, it, es oder pt, um die Namen der Tierarten in einer anderen Sprache zu erhalten.

Optionale Parameter, die an die Adresse angehängt werden (?species=…&litters=all):

species=<code>: nur die Tiere einer Tierart, angegeben über ihren Code (das Feld species.code der Antwort).
litters=all: schließt auch abgeschlossene Würfe ein; standardmäßig werden nur laufende Würfe geliefert.
lang=<code>: Sprache der Tierartnamen, anstelle der Sprache in der Adresse.

Verwendung

Die Adresse wird direkt aus dem Browser Ihrer Besucher aufgerufen, von jeder beliebigen Website aus: kein Schlüssel, keine Anmeldung, kein Zwischenserver nötig.
Die Antworten werden 5 Minuten zwischengespeichert: Eine Änderung in der App kann bis zu 5 Minuten brauchen, bis sie erscheint.
Jeder Besucher ist auf 90 Aufrufe pro Minute begrenzt, mehr als genug für eine normale Anzeige.
Ist der Webservice nicht aktiviert, antwortet die Adresse mit einem Fehler 403 und dem Code PublicApiDisabled. Existiert die Organisation nicht, antwortet sie mit einem Fehler 404 und dem Code OrganizationNotFound.
Die Fotoadressen (photo, photos[].url) sind dauerhaft und leiten zum Bild weiter: Verwenden Sie sie unverändert in <img src>. Kopieren Sie nicht die Adresse, zu der sie weiterleiten: Sie läuft nach einer Stunde ab.

Beispielantwort

Gekürzte Antwort für eine Zucht:

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

Bei einem Tierheim trägt jedes Tier einen Block refuge anstelle des Blocks breeder:

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

Der Status eines Welpen (status) ist available (verfügbar), reserved (reserviert) oder sold (verkauft). Der eines Tierheimtiers ist ADOPTABLE (zur Vermittlung), FOSTER (in einer Pflegestelle) oder RESERVED (reserviert).

Anzeigebeispiel

Das ist das Beispiel hinter der Schaltfläche Beispiel kopieren: Es zeigt Foto, Name und Beschreibung jedes Tieres an. Ersetzen Sie die Adresse durch Ihre eigene.

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

Die Texte werden mit textContent eingefügt, nie mit innerHTML: So lassen sich Texte aus fremden Quellen gefahrlos anzeigen.

Häufige Fragen

Ich habe ein Tier geändert, aber meine Website zeigt noch die alte Version.

Die Informationen werden 5 Minuten zwischengespeichert: Warten Sie einige Minuten und laden Sie dann die Seite Ihrer Website neu.

Wie beende ich das Teilen?

Deaktivieren Sie Webservice für Tiere erlauben unter Einstellungen > Öffentliche Seite und Website (die Änderung wird sofort gespeichert). Die Adresse liefert Ihre Tiere spätestens 5 Minuten danach nicht mehr.

Kann ich ein bestimmtes Tier nicht anzeigen lassen?

Ja: Blenden Sie es aus oder archivieren Sie es. Bei einem Tierheim können Sie in seinem Steckbrief auch die Sichtbarkeit auf der öffentlichen Seite abwählen.