Ressourcen für Entwickler und Agenten von Rishtay Walay
Wie sich diese Website programmatisch lesen lässt: Content-Negotiation für Markdown, maschinenlesbare Indexdateien und strukturierte Daten.
Was verfügbar ist
Diese Seite dokumentiert, was Rishtay Walay Programmen zur Verfügung stellt — KI-Agenten, Crawlern und Skripten. Kurz gesagt: Jede öffentliche Seite liefert auf Anfrage sauberes Markdown anstelle von HTML, es gibt Indexdateien mit einer Übersicht dessen, was die Website veröffentlicht, und die Seiten tragen strukturierte Daten. Für Mitgliederdaten gibt es keine öffentliche API.
Content-Negotiation für Markdown
Fordern Sie Markdown an, und Sie erhalten Markdown — von derselben URL, die auch die HTML-Seite ausliefert. Das folgt der Konvention von acceptmarkdown.com, also der gewöhnlichen proaktiven HTTP-Content-Negotiation nach RFC 9110.
curl -H 'Accept: text/markdown' https://rishtaywalay.com/pricing
curl https://rishtaywalay.com/pricing.md- Markdown-Antworten werden mit Content-Type: text/markdown; charset=utf-8 ausgeliefert.
- Antworten tragen Vary: Accept, damit gemeinsam genutzte Caches die HTML- und die Markdown-Variante getrennt halten.
- Eine Anfrage, deren Accept-Header sowohl text/html als auch text/markdown ausschließt, erhält 406 Not Acceptable.
- Auch Pfade mit Sprachpräfix funktionieren: /ur/pricing.md liefert das Markdown auf Urdu.
Maschinenlesbare Dateien
Diese Dateien beschreiben die Website in einer Form, die zum Lesen durch Maschinen gemacht ist.
- /llms.txt — Structured index of this site for language models (llmstxt.org format).
- /llms-full.txt — Expanded single-document context: features, plans, FAQs, branches, policies.
- /agents.md — When to use this service, what it can and cannot answer, and how to call it.
- /developers — The public JSON endpoint, content negotiation, structured data and locale coverage.
- /sitemap.xml — Every indexable URL across all 8 locales with hreflang alternates.
- /robots.txt — Crawl rules. AI crawlers are explicitly allowed on public pages.
Keine öffentliche API, keine OpenAPI-Spezifikation, kein CLI — mit Absicht
Es gibt keine öffentliche API für Profildaten, keine OpenAPI-Spezifikation und kein Kommandozeilenwerkzeug (CLI). Das ist eine bewusste Entscheidung und keine Lücke. Die Pfade unter /api/ existieren allein dafür, die Seiten dieser Website selbst zu bedienen, sie sind in der robots.txt untersagt, und sie führen personenbezogene Angaben von Mitgliedern mit sich — Namen, Geburtsdaten, Stadt, Kaste (biradari) und Konfession. Eine maschinenlesbare Spezifikation für diese Fläche zu veröffentlichen, käme dem Aushändigen einer Sammelanleitung für personenbezogene Daten gleich, deren massenhafter Erhebung die betroffenen Menschen nie zugestimmt haben.
Wenn Sie etwas entwickeln, das wirklich eine Anbindung an Rishtay Walay braucht, schreiben Sie uns und beschreiben Sie Ihr Vorhaben. Über eine Partner-API mit Authentifizierung und Ratenbegrenzung lässt sich reden; über eine öffentliche API ohne Authentifizierung nicht. In der Zwischenzeit decken die Markdown-Darstellungen, die Indexdateien und die strukturierten Daten weiter unten die Seiten, Pläne, Filialen und Richtlinien ab, ohne Mitgliederdaten zu berühren.
Strukturierte Daten
Öffentliche Seiten tragen strukturierte Daten als JSON-LD, sodass Sie Angaben auslesen können, ohne Fließtext zu parsen.
- Organization, WebSite und LocalBusiness auf der Startseite und der Seite „Über uns“.
- FAQPage für die auf der Startseite beantworteten Fragen.
- ProfilePage auf den einzelnen Profilseiten.
- BreadcrumbList auf den Bereichsseiten.
Sprachen und URLs
Die Seiten werden in 8 Sprachen veröffentlicht: en, ur, ar, hi, fr, de, es, tr. Englische URLs haben kein Präfix, zum Beispiel /pricing; andere Sprachen tragen ein Präfix, zum Beispiel /ur/pricing. Jede Seite deklariert hreflang-Alternativen, und die XML-Sitemap listet alle Sprachvarianten auf.
Höflich crawlen
Wenn Sie die Website crawlen, machen ein paar Dinge es für beide Seiten angenehmer.
- Lesen Sie zuerst die robots.txt. Große KI-Crawler, darunter GPTBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot und Google-Extended, sind auf öffentlichen Seiten ausdrücklich erlaubt.
- Kontobereiche und /api/ sind nicht erlaubt. Sie enthalten Mitgliederdaten und erfordern eine Anmeldung.
- Bevorzugen Sie die Markdown-Darstellung. Sie ist nur ein Bruchteil der Bytes und enthält keine Navigation, keine Stile und keine Skripte.
- Beginnen Sie bei llms.txt oder der XML-Sitemap, statt blind zu crawlen.
Statusprüfung
Ein schlanker Endpunkt für Lebenszeichen, gedacht für die Verfügbarkeitsüberwachung. Nutzen Sie ihn, anstatt eine Seite abzurufen.
curl https://rishtaywalay.com/api/health
{"status":"ok"}Kontakt aufnehmen
Fragen zu all dem oder zum Zugang für etwas, das die Markdown-Dateien nicht abdecken, sind willkommen.