موارد المطورين والوكلاء في Rishtay Walay
كيف تقرأ هذا الموقع برمجيًا: تفاوض المحتوى بصيغة Markdown، وملفات فهرسة قابلة للقراءة آليًا، وبيانات منظمة.
ما هو المتاح
توثّق هذه الصفحة ما يوفّره Rishtay Walay للبرامج — وكلاء الذكاء الاصطناعي وبرامج الزحف والنصوص البرمجية. باختصار: كل صفحة عامة ستعطيك Markdown نظيفًا بدلًا من HTML إذا طلبت ذلك، وهناك ملفات فهرسة تسرد ما ينشره الموقع، والصفحات تحمل بيانات منظمة. ولا توجد API عامة لبيانات الأعضاء.
تفاوض المحتوى بصيغة Markdown
اطلب Markdown وستحصل على Markdown، من الرابط نفسه الذي يخدم صفحة HTML. يتبع ذلك اتفاقية acceptmarkdown.com، وهي تفاوض محتوى استباقي عادي في HTTP كما هو معرّف في RFC 9110.
curl -H 'Accept: text/markdown' https://rishtaywalay.com/pricing
curl https://rishtaywalay.com/pricing.md- تُرسل استجابات Markdown بترويسة Content-Type: text/markdown; charset=utf-8.
- تحمل الاستجابات ترويسة Vary: Accept، حتى تفصل الذواكر المؤقتة المشتركة بين نسخة HTML ونسخة Markdown.
- الطلب الذي تستبعد ترويسة Accept فيه كلًا من text/html و text/markdown يحصل على 406 Not Acceptable.
- المسارات التي تحمل بادئة اللغة تعمل أيضًا: /ur/pricing.md يعيد نسخة Markdown بالأردية.
ملفات قابلة للقراءة آليًا
تصف هذه الملفات الموقع في صيغة مُعدّة لتقرأها الآلات.
- /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 عامة بلا مصادقة فلا. وفي غضون ذلك، تغطّي تمثيلات Markdown وملفات الفهرسة والبيانات المنظّمة أدناه الصفحات والباقات والفروع والسياسات دون المساس ببيانات الأعضاء.
البيانات المنظمة
تحمل الصفحات العامة بيانات منظمة بصيغة JSON-LD، حتى تستخلص المعلومات دون تحليل النصوص.
- المخططات Organization وWebSite وLocalBusiness في الصفحة الرئيسية وصفحة من نحن.
- المخطط FAQPage للأسئلة المُجاب عنها في الصفحة الرئيسية.
- المخطط ProfilePage في صفحات الملفات الشخصية الفردية.
- المخطط BreadcrumbList في صفحات الأقسام.
اللغات والروابط
تُنشر الصفحات في 8 لغات: en, ur, ar, hi, fr, de, es, tr. روابط الإنجليزية بلا بادئة، مثل /pricing؛ أما اللغات الأخرى فتحمل بادئة، مثل /ur/pricing. وتعلن كل صفحة عن بدائل hreflang، وتسرد خريطة الموقع XML جميع نسخ اللغات.
الزحف بأدب
إذا كنت تزحف على الموقع، فهناك أمور قليلة تجعل الأمر أفضل لنا جميعًا.
- اقرأ robots.txt أولًا. برامج زحف الذكاء الاصطناعي الرئيسية، ومنها GPTBot وChatGPT-User وClaudeBot وanthropic-ai وPerplexityBot وGoogle-Extended، مسموح لها صراحةً بالوصول إلى الصفحات العامة.
- أقسام الحساب و/api/ محظورة. فهي تحتوي على بيانات الأعضاء وتتطلب تسجيل الدخول.
- فضّل نسخة Markdown. فحجمها جزء بسيط من البايتات ولا تحمل عناصر تنقل ولا أنماطًا ولا نصوصًا برمجية.
- ابدأ من llms.txt أو من خريطة الموقع XML بدلًا من الزحف العشوائي.
فحص الحالة
نقطة نهاية خفيفة للتحقق من التشغيل، مخصصة لمراقبة الجهوزية. استخدمها بدلًا من طلب صفحة كاملة.
curl https://rishtaywalay.com/api/health
{"status":"ok"}كيفية التواصل معنا
نرحّب بأي أسئلة عن هذه الأمور، أو عن الوصول إلى شيء لا تغطيه ملفات Markdown.
