رشتے والے کے ڈویلپر اور ایجنٹ وسائل
اس سائٹ کو پروگرام کے ذریعے پڑھنے کا طریقہ: مارک ڈاؤن کے لیے کنٹینٹ نیگوشی ایشن، مشین سے پڑھی جانے والی انڈیکس فائلیں، اور اسٹرکچرڈ ڈیٹا۔
کیا کچھ دستیاب ہے
یہ صفحہ بتاتا ہے کہ رشتے والے پروگراموں — AI ایجنٹس، کرالرز اور اسکرپٹس — کے لیے کیا کچھ فراہم کرتا ہے۔ مختصراً: ہر عوامی صفحہ مانگنے پر HTML کے بجائے صاف مارک ڈاؤن دے دیتا ہے، سائٹ جو کچھ شائع کرتی ہے اس کی فہرست والی انڈیکس فائلیں موجود ہیں، اور صفحات میں اسٹرکچرڈ ڈیٹا شامل ہوتا ہے۔ ممبران کے ڈیٹا کے لیے کوئی عوامی API نہیں ہے۔
مارک ڈاؤن کنٹینٹ نیگوشی ایشن
مارک ڈاؤن مانگیں تو آپ کو مارک ڈاؤن ہی ملے گا، اُسی URL سے جو HTML صفحہ دیتا ہے۔ یہ acceptmarkdown.com کے طریقے کے مطابق ہے، جو دراصل وہی عام HTTP پروایکٹو کنٹینٹ نیگوشی ایشن ہے جو RFC 9110 میں بیان کی گئی ہے۔
curl -H 'Accept: text/markdown' https://rishtaywalay.com/pricing
curl https://rishtaywalay.com/pricing.md- مارک ڈاؤن جوابات Content-Type: text/markdown; charset=utf-8 کے ساتھ بھیجے جاتے ہیں۔
- جوابات کے ساتھ Vary: Accept بھی جاتا ہے، تاکہ مشترکہ کیشز HTML اور مارک ڈاؤن کے ورژن الگ الگ رکھیں۔
- جس درخواست کا Accept ہیڈر text/html اور text/markdown دونوں کو خارج کر دے، اسے 406 Not Acceptable ملتا ہے۔
- زبان کے پریفکس والے راستے بھی کام کرتے ہیں: /ur/pricing.md اردو مارک ڈاؤن دیتا ہے۔
مشین سے پڑھی جانے والی فائلیں
یہ فائلیں سائٹ کو ایسی صورت میں بیان کرتی ہیں جو مشینوں کے پڑھنے کے لیے بنائی گئی ہے۔
- /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.
نہ عوامی API، نہ OpenAPI اسپیسیفیکیشن، نہ CLI — یہ جان بوجھ کر ہے
پروفائل ڈیٹا کے لیے کوئی عوامی API نہیں ہے، کوئی OpenAPI اسپیسیفیکیشن نہیں، اور کوئی کمانڈ لائن (CLI) ٹول نہیں۔ یہ ایک سوچا سمجھا فیصلہ ہے، کوئی کمی یا ادھورا کام نہیں۔ /api/ کے تحت آنے والے راستے صرف اسی سائٹ کے اپنے صفحات چلانے کے لیے موجود ہیں، robots.txt میں ان کی اجازت نہیں دی گئی، اور ان میں ممبران کی ذاتی تفصیلات ہوتی ہیں — نام، تاریخِ پیدائش، شہر، ذات (برادری) اور مسلک۔ اس سطح کے لیے مشین سے پڑھی جانے والی اسپیسیفیکیشن شائع کرنا دراصل ایسے ذاتی ڈیٹا کو جمع کرنے کی رہنما کتاب تھما دینے کے مترادف ہوگا، جس ڈیٹا کو بڑے پیمانے پر اکٹھا کیے جانے پر متعلقہ لوگوں نے کبھی رضامندی دی ہی نہیں۔
اگر آپ کوئی ایسی چیز بنا رہے ہیں جسے واقعی رشتے والے (Rishtay Walay) کے ساتھ انٹیگریشن درکار ہے، تو ہمیں لکھیں اور اس کی تفصیل بتائیں۔ توثیق اور ریٹ لِمٹس کے ساتھ پارٹنر API ایسی بات ہے جس پر ہم گفتگو کے لیے تیار ہیں؛ بغیر توثیق والا عوامی API نہیں۔ اِس دوران نیچے دی گئی مارک ڈاؤن نمائندگیاں، انڈیکس فائلیں اور اسٹرکچرڈ ڈیٹا، ممبران کے ڈیٹا کو چھوئے بغیر، صفحات، پلانز، برانچز اور پالیسیوں کا احاطہ کرتے ہیں۔
اسٹرکچرڈ ڈیٹا
عوامی صفحات میں JSON-LD اسٹرکچرڈ ڈیٹا موجود ہے، تاکہ آپ عبارت کو پارس کیے بغیر حقائق نکال سکیں۔
- ہوم پیج اور تعارفی صفحے پر Organization، WebSite اور LocalBusiness۔
- ہوم پیج پر دیے گئے سوالوں کے لیے FAQPage۔
- انفرادی پروفائل صفحات پر ProfilePage۔
- سیکشن کے صفحات پر BreadcrumbList۔
زبانیں اور URL
صفحات 8 زبانوں میں شائع ہوتے ہیں: en, ur, ar, hi, fr, de, es, tr۔ انگریزی کے URL بغیر کسی پریفکس کے ہوتے ہیں، مثلاً /pricing؛ باقی زبانوں کے ساتھ پریفکس لگتا ہے، مثلاً /ur/pricing۔ ہر صفحہ hreflang متبادل بتاتا ہے اور XML سائٹ میپ میں تمام زبانوں کے ورژن درج ہیں۔
شائستگی سے کرالنگ
اگر آپ سائٹ کو کرال کر رہے ہیں تو چند باتیں ہم دونوں کے لیے معاملہ بہتر بنا دیں گی۔
- سب سے پہلے robots.txt پڑھیں۔ بڑے AI کرالرز، بشمول GPTBot، ChatGPT-User، ClaudeBot، anthropic-ai، PerplexityBot اور Google-Extended، کو عوامی صفحات پر واضح اجازت دی گئی ہے۔
- اکاؤنٹ کے حصوں اور /api/ کی اجازت نہیں ہے۔ ان میں ممبران کا ڈیٹا ہوتا ہے اور ان کے لیے لاگ ان ضروری ہے۔
- مارک ڈاؤن نمائندگی کو ترجیح دیں۔ یہ بائٹس کے لحاظ سے بہت چھوٹی ہوتی ہے اور اس میں نیویگیشن، اسٹائلز یا اسکرپٹس نہیں ہوتے۔
- اندھا دھند کرال کرنے کے بجائے llms.txt یا XML سائٹ میپ سے شروع کریں۔
ہیلتھ چیک
ایک ہلکا سا لائیونیس اینڈ پوائنٹ، جو اپ ٹائم مانیٹرنگ کے لیے ہے۔ کسی صفحے کی درخواست کرنے کے بجائے یہی استعمال کریں۔
curl https://rishtaywalay.com/api/health
{"status":"ok"}ہم سے رابطہ
ان میں سے کسی بھی بات کے بارے میں سوال، یا ایسی چیز تک رسائی کے بارے میں جو مارک ڈاؤن فائلوں میں شامل نہیں، خوش آمدید۔