Recursos para desarrolladores y agentes de Rishtay Walay
Cómo leer este sitio de forma programática: negociación de contenido en markdown, archivos de índice legibles por máquinas y datos estructurados.
Qué hay disponible
Esta página documenta lo que Rishtay Walay expone a los programas: agentes de IA, rastreadores y scripts. En resumen: cualquier página pública te devolverá markdown limpio en lugar de HTML si lo pides, hay archivos de índice que enumeran lo que publica el sitio y las páginas llevan datos estructurados. No existe una API pública para los datos de los miembros.
Negociación de contenido en markdown
Pide markdown y obtendrás markdown, desde la misma URL que sirve la página HTML. Esto sigue la convención de acceptmarkdown.com, que es la negociación proactiva de contenido HTTP corriente, tal como se define en RFC 9110.
curl -H 'Accept: text/markdown' https://rishtaywalay.com/pricing
curl https://rishtaywalay.com/pricing.md- Las respuestas en markdown se envían con Content-Type: text/markdown; charset=utf-8.
- Las respuestas llevan Vary: Accept, para que las cachés compartidas mantengan separadas las variantes en HTML y en markdown.
- Una solicitud cuya cabecera Accept descarta tanto text/html como text/markdown recibe un 406 Not Acceptable.
- Las rutas con prefijo de idioma también funcionan: /ur/pricing.md devuelve el markdown en urdu.
Archivos legibles por máquinas
Estos archivos describen el sitio en un formato pensado para que lo lean las máquinas.
- /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.
Sin API pública, sin especificación OpenAPI y sin CLI: es deliberado
No existe una API pública para los datos de los perfiles, ni una especificación OpenAPI, ni una herramienta CLI de línea de comandos. Es una decisión tomada a conciencia, no una carencia. Las rutas bajo /api/ existen únicamente para servir las propias páginas de este sitio, están prohibidas en robots.txt y llevan datos personales de los miembros: nombres, fechas de nacimiento, ciudad, casta y secta. Publicar una especificación legible por máquinas de esa superficie equivaldría a repartir un manual de recolección de datos personales que las personas afectadas nunca aceptaron que se recopilaran de forma masiva.
Si estás creando algo que de verdad necesita una integración con Rishtay Walay, escríbenos y descríbenoslo. Una API para socios, con autenticación y límites de uso, es una conversación que estamos dispuestos a tener; una API pública sin autenticación, no. Mientras tanto, las representaciones en markdown, los archivos de índice y los datos estructurados que aparecen más abajo cubren las páginas, los planes, las sucursales y las políticas sin tocar los datos de los miembros.
Datos estructurados
Las páginas públicas llevan datos estructurados JSON-LD, así que puedes extraer los datos sin analizar el texto.
- Organization, WebSite y LocalBusiness en la página de inicio y en la página sobre nosotros.
- FAQPage para las preguntas respondidas en la página de inicio.
- ProfilePage en las páginas de perfil individuales.
- BreadcrumbList en las páginas de sección.
Idiomas y URL
Las páginas se publican en 8 idiomas: en, ur, ar, hi, fr, de, es, tr. Las URL en inglés no llevan prefijo, por ejemplo /pricing; los demás idiomas llevan un prefijo, por ejemplo /ur/pricing. Cada página declara alternativas hreflang y el sitemap XML enumera todas las variantes de idioma.
Rastrear con cortesía
Si vas a rastrear el sitio, unas pocas cosas harán que salga mejor para las dos partes.
- Lee primero robots.txt. Los principales rastreadores de IA, incluidos GPTBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot y Google-Extended, están permitidos explícitamente en las páginas públicas.
- Las áreas de cuenta y /api/ están prohibidas. Contienen datos de los miembros y requieren inicio de sesión.
- Prefiere la representación en markdown. Ocupa una fracción de los bytes y no lleva navegación, estilos ni scripts.
- Empieza por llms.txt o por el sitemap XML en lugar de rastrear a ciegas.
Comprobación de estado
Un endpoint ligero de disponibilidad, pensado para la monitorización del tiempo de actividad. Úsalo en lugar de solicitar una página.
curl https://rishtaywalay.com/api/health
{"status":"ok"}Cómo ponerte en contacto
Cualquier duda sobre todo esto, o sobre el acceso a algo que los archivos markdown no cubran, es bienvenida.
