{"openapi":"3.1.0","info":{"title":"Jamaat Public Knowledge API","version":"1.0.0","description":"API عمومی و باز جماعت برای ربات‌ها، ایجنت‌های هوش مصنوعی و یکپارچه‌سازی‌های شخص ثالث.\n\n**بدون احراز هویت** — فقط محتوای منتشرشده و عمومی.\n\n- MCP: https://jamaat.life/mcp\n- Docs: https://jamaat.life/developers\n- llms.txt: https://jamaat.life/llms.txt\n\n- Developer docs: https://jamaat.life/developers\n- llms.txt: https://jamaat.life/llms.txt\n- OpenAPI 3.1: https://jamaat.life/openapi.json\n- Well-known OpenAPI: https://jamaat.life/.well-known/openapi.json\n- robots.txt: https://jamaat.life/robots.txt\n- Sitemap: https://jamaat.life/sitemap.xml","contact":{"name":"Jamaat Platform","url":"https://jamaat.life"}},"servers":[{"url":"https://api.jamaat.life","description":"Public API"}],"tags":[{"name":"knowledge","description":"دانش و محتوای عمومی سایت"},{"name":"feeds","description":"فیدهای عمومی (روی دامنه اصلی سایت)"},{"name":"previews","description":"پیش‌نمایش HTML برای crawlerها"},{"name":"discovery","description":"کشف خودکار"}],"paths":{"/api/v1/knowledge/tenants":{"get":{"tags":["knowledge"],"summary":"لیست tenantهای فعال","description":"همه سایت‌های فعال پلتفرم جماعت","operationId":"listTenants","parameters":[],"responses":{"200":{"description":"{ tenants: [{ id, slug, name, ... }] }","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/overview":{"get":{"tags":["knowledge"],"summary":"نمای کلی محتوای سایت","description":"آمار مقالات، تست‌ها، محصولات، خدمات و دسته‌بندی‌ها","operationId":"getOverview","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}}],"responses":{"200":{"description":"{ tenant, contentCounts, categories, catalogTemplates, urlPaths }","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/search":{"get":{"tags":["knowledge"],"summary":"جستجوی یکپارچه","description":"جستجو در بلاگ، مقالات علمی، تست‌ها، محصولات و خدمات","operationId":"searchContent","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"page","in":"query","description":"شماره صفحه","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"تعداد نتایج (حداکثر ۵۰)","schema":{"type":"integer"}},{"name":"search","in":"query","description":"عبارت جستجو","schema":{"type":"string"}},{"name":"types","in":"query","description":"فیلتر نوع: blog, scholarly-article, psych-test, product, service (جدا با کاما)","schema":{"type":"string","enum":["blog","scholarly-article","psych-test","product","service"]}}],"responses":{"200":{"description":"{ query, types, total, results: [{ type, slug, title, excerpt, urlPath }] }","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/blog-posts":{"get":{"tags":["knowledge"],"summary":"لیست مقالات بلاگ","description":"مقالات منتشرشده با صفحه‌بندی","operationId":"listBlogPosts","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"page","in":"query","description":"شماره صفحه","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"تعداد نتایج (حداکثر ۵۰)","schema":{"type":"integer"}},{"name":"search","in":"query","description":"عبارت جستجو","schema":{"type":"string"}},{"name":"category","in":"query","description":"دسته‌بندی","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/blog-posts/{slug}":{"get":{"tags":["knowledge"],"summary":"جزئیات مقاله بلاگ","description":"متن کامل HTML و نسخه plain-text","operationId":"getBlogPost","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"slug","in":"path","required":true,"description":"شناسه URL","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/scholarly-articles":{"get":{"tags":["knowledge"],"summary":"لیست مقالات علمی","description":"مقالات علمی منتشرشده","operationId":"listScholarlyArticles","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"page","in":"query","description":"شماره صفحه","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"تعداد نتایج (حداکثر ۵۰)","schema":{"type":"integer"}},{"name":"search","in":"query","description":"عبارت جستجو","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/scholarly-articles/{slug}":{"get":{"tags":["knowledge"],"summary":"جزئیات مقاله علمی","description":"شامل نویسندگان، منابع و متن کامل","operationId":"getScholarlyArticle","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"slug","in":"path","required":true,"description":"شناسه URL","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/psych-tests":{"get":{"tags":["knowledge"],"summary":"لیست تست‌های روانشناختی","description":"تست‌های فعال با دسته‌بندی","operationId":"listPsychTests","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"page","in":"query","description":"شماره صفحه","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"تعداد نتایج (حداکثر ۵۰)","schema":{"type":"integer"}},{"name":"search","in":"query","description":"عبارت جستجو","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/psych-tests/{slug}":{"get":{"tags":["knowledge"],"summary":"جزئیات تست روانشناختی","description":"سوالات، گزینه‌ها و باندهای نمره","operationId":"getPsychTest","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"slug","in":"path","required":true,"description":"شناسه URL","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/products":{"get":{"tags":["knowledge"],"summary":"لیست محصولات","description":"دوره‌ها و بسته‌های آموزشی فعال","operationId":"listProducts","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"page","in":"query","description":"شماره صفحه","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"تعداد نتایج (حداکثر ۵۰)","schema":{"type":"integer"}},{"name":"search","in":"query","description":"عبارت جستجو","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/services":{"get":{"tags":["knowledge"],"summary":"لیست خدمات","description":"خدمات مشاوره و روانشناسی فعال","operationId":"listServices","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}},{"name":"page","in":"query","description":"شماره صفحه","schema":{"type":"integer"}},{"name":"limit","in":"query","description":"تعداد نتایج (حداکثر ۵۰)","schema":{"type":"integer"}},{"name":"search","in":"query","description":"عبارت جستجو","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/api/v1/knowledge/integration-docs":{"get":{"tags":["knowledge"],"summary":"مستندات سیستم ارتباطی (این صفحه)","description":"ساختار JSON کامل مستندات — برای رندر داینامیک","operationId":"integrationDocs","parameters":[{"name":"tenantSlug","in":"query","description":"شناسه tenant — اگر ارسال نشود tenant پیش‌فرض استفاده می‌شود","schema":{"type":"string"}}],"responses":{"200":{"description":"همان ساختاری که این صفحه از آن استفاده می‌کند","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object"}}}}}}}}},"/feed.json":{"get":{"tags":["feeds"],"summary":"فید JSON یکپارچه","description":"همه انواع محتوا: بلاگ، تحقیق، محصول، خدمت، تست","servers":[{"url":"https://jamaat.life"}],"responses":{"200":{"description":"JSON Feed 1.1","content":{"application/feed+json":{"schema":{"type":"object"}}}}}}},"/atom.xml":{"get":{"tags":["feeds"],"summary":"فید Atom","description":"۵۰ آیتم اخیر از همه انواع محتوا","servers":[{"url":"https://jamaat.life"}],"responses":{"200":{"description":"Atom 1.0","content":{"application/atom+xml":{"schema":{"type":"object"}}}}}}},"/feeds/meta.xml":{"get":{"tags":["feeds"],"summary":"فید Meta/Facebook","description":"content:encoded، media:content و preview URL برای Open Graph","servers":[{"url":"https://jamaat.life"}],"responses":{"200":{"description":"RSS 2.0 + Media RSS","content":{"application/rss+xml":{"schema":{"type":"object"}}}}}}},"/rss.xml":{"get":{"tags":["feeds"],"summary":"فید RSS بلاگ","description":"۵۰ مقاله اخیر بلاگ","servers":[{"url":"https://jamaat.life"}],"responses":{"200":{"description":"RSS 2.0","content":{"application/rss+xml":{"schema":{"type":"object"}}}}}}},"/preview/blog/{slug}":{"get":{"tags":["previews"],"summary":"HTML preview بلاگ","description":"صفحه HTML با Open Graph و JSON-LD برای crawlerها","servers":[{"url":"https://api.jamaat.life"}],"parameters":[{"name":"slug","in":"path","required":true,"description":"شناسه URL","schema":{"type":"string"}}],"responses":{"200":{"description":"HTML","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/preview/research/{slug}":{"get":{"tags":["previews"],"summary":"HTML preview مقاله علمی","description":"صفحه HTML با citation meta و Schema.org","servers":[{"url":"https://api.jamaat.life"}],"parameters":[{"name":"slug","in":"path","required":true,"description":"شناسه URL","schema":{"type":"string"}}],"responses":{"200":{"description":"HTML","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"x-mcp":{"url":"https://jamaat.life/mcp","transport":"streamable-http","public":true,"tools":["get_site_overview","list_tenants","search_site_content","list_blog_posts","get_blog_post","list_scholarly_articles","get_scholarly_article","list_psych_tests","get_psych_test","list_products","list_services"]}}