Ressources Rishtay Walay pour développeurs et agents

Cette page documente ce que Rishtay Walay expose aux programmes — agents d'IA, robots d'exploration et scripts. En résumé : chaque page publique vous renvoie du markdown propre plutôt que du HTML si vous le demandez, des fichiers d'index recensent ce que le site publie, et les pages contiennent des données structurées. Il n'existe aucune API publique pour les données des membres.

Demandez du markdown et vous obtiendrez du markdown, depuis la même URL que celle qui sert la page HTML. Cela suit la convention acceptmarkdown.com, qui n'est autre que la négociation proactive de contenu HTTP définie par la RFC 9110.

curl -H 'Accept: text/markdown' https://rishtaywalay.com/pricing
curl https://rishtaywalay.com/pricing.md

• Les réponses en markdown sont envoyées avec Content-Type: text/markdown; charset=utf-8.
• Les réponses portent l'en-tête Vary: Accept, afin que les caches partagés distinguent la variante HTML de la variante markdown.
• Une requête dont l'en-tête Accept exclut à la fois text/html et text/markdown reçoit une réponse 406 Not Acceptable.
• Les chemins préfixés par la langue fonctionnent également : /ur/pricing.md renvoie le markdown en ourdou.

Ces fichiers décrivent le site sous une forme conçue pour être lue par des machines.

• /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.

Il n'existe aucune API publique pour les données de profil, aucune spécification OpenAPI et aucun outil en ligne de commande (CLI). C'est une décision, pas une lacune. Les chemins sous /api/ n'existent que pour servir les pages de ce site, ils sont interdits dans robots.txt, et ils transportent les données personnelles des membres — noms, dates de naissance, ville, caste (biradari) et secte. Publier une spécification lisible par machine pour cette surface reviendrait à distribuer un guide de collecte de données personnelles que les personnes concernées n'ont jamais accepté de voir rassemblées en masse.

Si vous construisez quelque chose qui a réellement besoin d'une intégration avec Rishtay Walay, écrivez-nous en la décrivant. Une API partenaire, avec authentification et limites de débit, est une discussion à laquelle nous sommes ouverts ; une API publique sans authentification ne l'est pas. En attendant, les représentations en markdown, les fichiers d'index et les données structurées ci-dessous couvrent les pages, les forfaits, les agences et les politiques sans toucher aux données des membres.

Les pages publiques contiennent des données structurées JSON-LD, ce qui permet d'extraire des informations sans analyser le texte.

• Organization, WebSite et LocalBusiness sur la page d'accueil et la page À propos.
• FAQPage pour les questions traitées sur la page d'accueil.
• ProfilePage sur les pages de profil individuelles.
• BreadcrumbList sur les pages de section.

Les pages sont publiées en 8 langues : en, ur, ar, hi, fr, de, es, tr. Les URL en anglais sont sans préfixe, par exemple /pricing ; les autres langues portent un préfixe, par exemple /ur/pricing. Chaque page déclare ses alternatives hreflang et le plan de site XML recense toutes les variantes linguistiques.

Si vous explorez le site, quelques points rendront l'opération plus simple pour vous comme pour nous.

• Lisez d'abord robots.txt. Les principaux robots d'IA, dont GPTBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot et Google-Extended, sont explicitement autorisés sur les pages publiques.
• Les espaces de compte et /api/ sont interdits. Ils contiennent des données de membres et nécessitent une connexion.
• Préférez la version markdown. Elle représente une fraction des octets et ne contient ni navigation, ni styles, ni scripts.
• Partez de llms.txt ou du plan de site XML plutôt que d'explorer à l'aveugle.

Un point de terminaison léger de vérification d'activité, destiné à la surveillance de la disponibilité. Utilisez-le plutôt que de demander une page.

curl https://rishtaywalay.com/api/health
{"status":"ok"}

Vos questions sur tout cela, ou sur l'accès à un élément que les fichiers markdown ne couvrent pas, sont bienvenues.

support@rishtaywalay.com