رشتے والے کے ڈویلپر اور ایجنٹ وسائل
اس سائٹ کو پروگرام کے ذریعے پڑھنے کا طریقہ: مارک ڈاؤن کے لیے کنٹینٹ نیگوشی ایشن، مشین سے پڑھی جانے والی انڈیکس فائلیں، اور اسٹرکچرڈ ڈیٹا۔
کیا کچھ دستیاب ہے
یہ صفحہ بتاتا ہے کہ رشتے والے پروگراموں — 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 موجود نہیں
پروفائل ڈیٹا کے لیے کوئی عوامی API نہیں ہے، اور API کی کا کوئی پروگرام بھی نہیں۔ پروفائلز اُن لوگوں کے لیے شائع کی جاتی ہیں جو شادی کے لیے ہمسفر سرچ کر رہے ہیں؛ یہ کسی ڈیٹا سیٹ کے طور پر پیش نہیں کی جاتیں، اور ممبران کا ڈیٹا دوبارہ استعمال کے لیے لائسنس شدہ نہیں ہے۔ /api/ کے تحت آنے والے راستے صرف اسی سائٹ کے اپنے صفحات چلانے کے لیے ہیں اور robots.txt میں ان کی اجازت نہیں دی گئی۔
اگر آپ کوئی ایسی چیز بنا رہے ہیں جس کے لیے رشتے والے کا ڈیٹا درکار ہے اور مارک ڈاؤن نمائندگی کافی نہیں، تو براہ کرم ہمیں لکھیں اور بتائیں کہ آپ کیا کرنا چاہتے ہیں۔ ہمیں یہ زیادہ پسند ہے کہ اس پر بات ہو، بجائے اس کے کہ آپ سائٹ کو اسکریپ کریں۔
اسٹرکچرڈ ڈیٹا
عوامی صفحات میں 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"}ہم سے رابطہ
ان میں سے کسی بھی بات کے بارے میں سوال، یا ایسی چیز تک رسائی کے بارے میں جو مارک ڈاؤن فائلوں میں شامل نہیں، خوش آمدید۔