Register · Entwickler

Das Register einbinden

Binden Sie eine Suche im offiziellen Gesundheitstourismus-Register der Türkei in Ihre Website ein: per Widget, HTML-Formular, Badge oder JSON-API.

Überblick

healthturkey.co spiegelt das Register des türkischen Gesundheitsministeriums mit den Einrichtungen, die zur Behandlung internationaler Patienten zugelassen sind, und prüft es täglich. Eine Suche in diesem Register können Sie auf drei Arten in Ihre eigene Website einbinden:

Alle drei sind kostenlos und brauchen weder API-Schlüssel noch Anmeldung. Jedes Ergebnis verlinkt auf den Eintrag der Einrichtung auf healthturkey.co.

Schnellstart

Fügen Sie dies dort ein, wo das Suchfeld erscheinen soll:

<div data-healthturkey="search" data-theme="light">
  <a href="https://healthturkey.co/">Register search by healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

Mehr ist nicht nötig. Das Skript findet jedes data-healthturkey-Element auf der Seite und macht daraus ein Suchfeld. Binden Sie das <script>-Tag nur einmal ein, auch wenn mehrere Widgets auf der Seite stehen.

Pflicht zur Quellenangabe

Jedes Snippet enthält einen Link auf healthturkey.co. Das Widget funktioniert nur, solange dieser Link vorhanden ist:

• Der Link muss im HTML der Seite stehen, innerhalb des Widget-Elements, wie im Snippet.
• Er darf kein rel="nofollow", ugc oder sponsored tragen, und die Seite darf kein nofollow-Robots-Meta-Tag haben.
• Er muss sichtbar sein: kein display:none, keine Deckkraft von null, keine winzige Schrift. Den Linktext dürfen Sie ändern, solange er healthturkey.co nennt.

Das Widget prüft das bei jedem Laden und zeigt statt des Suchfelds einen kurzen Hinweis, wenn der Link die Prüfung nicht besteht. Zusätzlich prüfen wir jede einbindende Seite einmal täglich; fehlt der Link, liefern Abfragen von dieser Website keine Ergebnisse, bis er wiederhergestellt ist. Außer dem Wiederherstellen des Links müssen Sie nichts tun.

Suche

Suchfeld mit darunter aufgelisteten Ergebnissen. Gesucht wird nach Klinikname, amtlichem Namen oder Zulassungsnummer. Jedes Ergebnis zeigt Typ, Stadt, Nummer und Registerstatus und öffnet den Eintrag auf healthturkey.co in einem neuen Tab.

<div data-healthturkey="search" data-theme="light">
  <a href="https://healthturkey.co/">Register search by healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

Kompakte Suche

Einzeilige Variante für Seitenleisten und Kopfbereiche. Ergebnisse öffnen sich in einem Dropdown und schließen sich mit Esc oder einem Klick außerhalb.

<div data-healthturkey="compact" data-theme="light">
  <a href="https://healthturkey.co/">Register search by healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

Prüfung der Zulassungsnummer

Nimmt eine Zulassungsnummer entgegen und gibt eine von drei Antworten: im Register, nicht mehr im Register oder keine Einrichtung mit dieser Nummer. Die Nummer muss exakt übereinstimmen.

<div data-healthturkey="licence" data-theme="light">
  <a href="https://healthturkey.co/">Authorisation numbers checked against healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

Konfiguration

Attribute

CSS-Variablen

Das Widget übernimmt die Schrift Ihrer Seite und nutzt die volle Breite seines Containers. Farben lassen sich am Element oder an einem übergeordneten Element überschreiben:

[data-healthturkey] {
  --ht-accent: #0B5FD9;
  --ht-radius: 8px;
}

HTML-Formular

Kein Skript. Beim Absenden öffnen sich die Suchergebnisse auf healthturkey.co in einem neuen Tab. Das Formular übernimmt die Formularstile Ihrer Website.

<form action="https://healthturkey.co/" method="get" target="_blank">
  <label for="ht-q">Check a clinic in Türkiye's health-tourism register</label>
  <input id="ht-q" type="search" name="q" placeholder="Clinic name or ST number" required>
  <button type="submit">Check</button>
  <p><a href="https://healthturkey.co/">Register search by healthturkey.co</a></p>
</form>

Klinik-Badge

Ein Bild für die eigene Website einer Einrichtung. Es zeigt das healthturkey.co-Zeichen, den Registerstatus, die Zulassungsnummer und das Datum der letzten Prüfung und ändert sich, wenn sich das Register ändert — eine Einrichtung, die aus dem Register gestrichen wird, bekommt ein Badge, das genau das sagt. Es ist ein einfacher Bildlink auf den Eintrag der Einrichtung, wo Besucher die Angabe prüfen können; auf Ihrer Seite läuft kein Skript.

Vorschau Taki Dent

<a href="https://healthturkey.co/clinic/taki-dent-antalya" target="_blank" rel="noopener" title="Check this licence on healthturkey.co">
  <img src="https://healthturkey.co/badge/taki-dent-antalya.svg" width="300" height="74" loading="lazy"
       alt="Taki Dent — verified in the official Turkish health-tourism register" />
</a>

Für dunkle Hintergründe hängen Sie ?theme=dark an die Bild-URL an.

Abfrage-Endpunkt

GET https://healthturkey.co/api/public/lookup?q={query}

Keine Authentifizierung. CORS ist für alle Origins offen. Antworten werden 24 Stunden zwischengespeichert; das Register wird einmal täglich aktualisiert. Es gilt die Pflicht zur Quellenangabe: Verlinken Sie jedes Ergebnis auf seine url und zeigen Sie dort, wo die Ergebnisse erscheinen, einen Link auf healthturkey.co ohne nofollow.

Beispielantwort

{
  "query": "ST-6335",
  "results": [
    {
      "name": "Taki Dent",
      "legal_name": "Özel Taki Dent Ağız ve Diş Sağlığı Polikliniği",
      "type": "Private Oral and Dental Health Clinic",
      "city": "Antalya",
      "authorisation_number": "ST-6335",
      "status": "listed",
      "url": "https://healthturkey.co/clinic/taki-dent-antalya"
    }
  ],
  "more_url": "https://healthturkey.co/?q=ST-6335",
  "source": "https://healthturkey.co/methodology"
}

Antwortfelder

Weitere Endpunkte

Siehe auch die Datensatz-Seite und die Methodik.

Fehlerbehebung

Die Browserkonsole zeigt denselben Grund, mit dem Präfix [healthturkey].

Häufige Fragen

Ist das kostenlos?

Ja. Kein Schlüssel, kein Kontingent, das Sie beantragen müssten.

Woher stammen die Daten?

Aus den öffentlichen Verzeichnissen des türkischen Gesundheitsministeriums, täglich geprüft. healthturkey.co ist vom Ministerium unabhängig. Siehe Methodik.

Kann ich Ergebnisse auf meiner eigenen Seite anzeigen?

Ja, mit der API. Verlinken Sie jedes Ergebnis auf seinen Eintrag.