{ "openapi": "3.0.0", "info": { "title": "WaqfData API", "version": "1.0.0", "description": "Free Islamic educational content API with AI-friendly metadata. Access structured JSON data for Asma ul Husna, Tajweed, Dhul-Hijjah benefits, and more.", "contact": { "name": "WaqfData", "url": "https://github.com/WaqfData" } }, "servers": [ { "url": "https://api.waqf.dev" } ], "paths": { "/_meta": { "get": { "summary": "Get API schema metadata", "description": "Returns comprehensive schema for all endpoints including field types, nested arrays, searchable fields, filterable fields, statistics, and query examples.", "operationId": "getMeta", "tags": [ "System" ], "responses": { "200": { "description": "Schema metadata for all endpoints", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "object", "properties": { "path": { "type": "string" }, "schema": { "type": "object" } } } } } } } } } }, "/_search": { "get": { "summary": "Global search across all datasets", "description": "Search across all datasets with Arabic text normalization support.", "operationId": "globalSearch", "tags": [ "System" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Search query term", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum number of results (default: 50)", "schema": { "type": "integer", "default": 50 } } ], "responses": { "200": { "description": "Search results from all datasets", "content": { "application/json": { "schema": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object" } }, "total": { "type": "integer" } } } } } }, "400": { "description": "Missing query parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/_health": { "get": { "summary": "Health check endpoint", "description": "Returns API health status for monitoring systems.", "operationId": "healthCheck", "tags": [ "System" ], "responses": { "200": { "description": "API is healthy", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "healthy" ] }, "timestamp": { "type": "string", "format": "date-time" }, "version": { "type": "string" } }, "required": [ "status", "timestamp", "version" ] } } } }, "503": { "description": "API is unhealthy", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "unhealthy" ] }, "timestamp": { "type": "string", "format": "date-time" }, "errors": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "/_openapi": { "get": { "summary": "Get OpenAPI specification", "description": "Returns the OpenAPI 3.0 specification document for this API.", "operationId": "getOpenAPISpec", "tags": [ "System" ], "responses": { "200": { "description": "OpenAPI 3.0 specification", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/44fth": { "get": { "summary": "Get 44fth data", "description": "Returns data from the 44fth dataset with filtering, pagination, and field selection support.", "operationId": "get44fth", "tags": [ "Data" ], "parameters": [ { "$ref": "#/components/parameters/limitParam" }, { "$ref": "#/components/parameters/offsetParam" }, { "$ref": "#/components/parameters/fieldsParam" }, { "$ref": "#/components/parameters/sortParam" }, { "name": "id", "in": "query", "description": "Filter by id", "schema": { "type": "integer" } }, { "name": "page_pdf", "in": "query", "description": "Filter by page_pdf", "schema": { "type": "integer" } }, { "name": "title_short_ar", "in": "query", "description": "Filter by title_short_ar (e.g., تفاضل الأزمان بعضها على بعض, نفحات وهبات الدهر)", "schema": { "type": "string" } }, { "name": "title_short_ar_like", "in": "query", "description": "Partial match filter for title_short_ar", "schema": { "type": "string" } }, { "name": "category_ar", "in": "query", "description": "Filter by category_ar (e.g., تفاضل الأزمان, الأعمال الصالحة)", "schema": { "type": "string" } }, { "name": "category_ar_like", "in": "query", "description": "Partial match filter for category_ar", "schema": { "type": "string" } }, { "name": "hashtag_ar", "in": "query", "description": "Filter by hashtag_ar (e.g., #كنوز_العشر #ذي_الحجة)", "schema": { "type": "string" } }, { "name": "hashtag_ar_like", "in": "query", "description": "Partial match filter for hashtag_ar", "schema": { "type": "string" } }, { "name": "id", "in": "query", "description": "Filter by id (e.g., q1, q2)", "schema": { "type": "string" } }, { "name": "id_like", "in": "query", "description": "Partial match filter for id", "schema": { "type": "string" } }, { "name": "benefitId", "in": "query", "description": "Filter by benefitId", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/44fth" }, { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/44fth" }, "pagination": { "$ref": "#/components/schemas/Pagination" } } } ] } } } }, "400": { "description": "Invalid query parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/44fth/_meta": { "get": { "summary": "Get 44fth schema metadata", "description": "Returns schema metadata and sample data for the 44fth endpoint.", "operationId": "get44fthMeta", "tags": [ "Metadata" ], "responses": { "200": { "description": "Schema metadata with sample data", "content": { "application/json": { "schema": { "type": "object", "properties": { "endpoint": { "type": "string" }, "schema": { "type": "object" }, "sample_data": { "type": "object" } } } } } }, "404": { "description": "Endpoint not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/AsmaaHusna": { "get": { "summary": "Get AsmaaHusna data", "description": "Returns data from the AsmaaHusna dataset with filtering, pagination, and field selection support.", "operationId": "getAsmaaHusna", "tags": [ "Data" ], "parameters": [ { "$ref": "#/components/parameters/limitParam" }, { "$ref": "#/components/parameters/offsetParam" }, { "$ref": "#/components/parameters/fieldsParam" }, { "$ref": "#/components/parameters/sortParam" }, { "name": "chapter_title", "in": "query", "description": "Filter by chapter_title (e.g., منزلة العلم بأسماء الله تعالى وصفاته, فضل العلم بأسماء الله تعالى وصفاته)", "schema": { "type": "string" } }, { "name": "chapter_title_like", "in": "query", "description": "Partial match filter for chapter_title", "schema": { "type": "string" } }, { "name": "number", "in": "query", "description": "Filter by number", "schema": { "type": "integer" } }, { "name": "name_arabic", "in": "query", "description": "Filter by name_arabic (e.g., الله, الرَّبُ)", "schema": { "type": "string" } }, { "name": "name_arabic_like", "in": "query", "description": "Partial match filter for name_arabic", "schema": { "type": "string" } }, { "name": "title", "in": "query", "description": "Filter by title (e.g., أسماء الله ليست محصورة)", "schema": { "type": "string" } }, { "name": "title_like", "in": "query", "description": "Partial match filter for title", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/AsmaaHusna" }, { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AsmaaHusna" }, "pagination": { "$ref": "#/components/schemas/Pagination" } } } ] } } } }, "400": { "description": "Invalid query parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/AsmaaHusna/_meta": { "get": { "summary": "Get AsmaaHusna schema metadata", "description": "Returns schema metadata and sample data for the AsmaaHusna endpoint.", "operationId": "getAsmaaHusnaMeta", "tags": [ "Metadata" ], "responses": { "200": { "description": "Schema metadata with sample data", "content": { "application/json": { "schema": { "type": "object", "properties": { "endpoint": { "type": "string" }, "schema": { "type": "object" }, "sample_data": { "type": "object" } } } } } }, "404": { "description": "Endpoint not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/MenhajDareseen-p79p102": { "get": { "summary": "Get MenhajDareseen-p79p102 data", "description": "Returns data from the MenhajDareseen-p79p102 dataset with filtering, pagination, and field selection support.", "operationId": "getMenhajDareseen-p79p102", "tags": [ "Data" ], "parameters": [ { "$ref": "#/components/parameters/limitParam" }, { "$ref": "#/components/parameters/offsetParam" }, { "$ref": "#/components/parameters/fieldsParam" }, { "$ref": "#/components/parameters/sortParam" }, { "name": "id", "in": "query", "description": "Filter by id", "schema": { "type": "integer" } }, { "name": "bloom_level", "in": "query", "description": "Filter by bloom_level (e.g., Remembering, Applying)", "schema": { "type": "string" } }, { "name": "bloom_level_like", "in": "query", "description": "Partial match filter for bloom_level", "schema": { "type": "string" } }, { "name": "question", "in": "query", "description": "Filter by question (e.g., ما هو تعريف المد لغةً كما ورد في النص؟, ما هو تعريف المد اصطلاحًا؟)", "schema": { "type": "string" } }, { "name": "question_like", "in": "query", "description": "Partial match filter for question", "schema": { "type": "string" } }, { "name": "correct_answer", "in": "query", "description": "Filter by correct_answer", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/MenhajDareseen-p79p102" }, { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/MenhajDareseen-p79p102" }, "pagination": { "$ref": "#/components/schemas/Pagination" } } } ] } } } }, "400": { "description": "Invalid query parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/MenhajDareseen-p79p102/_meta": { "get": { "summary": "Get MenhajDareseen-p79p102 schema metadata", "description": "Returns schema metadata and sample data for the MenhajDareseen-p79p102 endpoint.", "operationId": "getMenhajDareseen-p79p102Meta", "tags": [ "Metadata" ], "responses": { "200": { "description": "Schema metadata with sample data", "content": { "application/json": { "schema": { "type": "object", "properties": { "endpoint": { "type": "string" }, "schema": { "type": "object" }, "sample_data": { "type": "object" } } } } } }, "404": { "description": "Endpoint not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/alEmanBeAllah": { "get": { "summary": "Get alEmanBeAllah data", "description": "Returns data from the alEmanBeAllah dataset with filtering, pagination, and field selection support.", "operationId": "getAlEmanBeAllah", "tags": [ "Data" ], "parameters": [ { "$ref": "#/components/parameters/limitParam" }, { "$ref": "#/components/parameters/offsetParam" }, { "$ref": "#/components/parameters/fieldsParam" }, { "$ref": "#/components/parameters/sortParam" }, { "name": "title", "in": "query", "description": "Filter by title (e.g., أولاً: هل عرفت الله حقاً؟, ثانياً: ما أدلة وجود الله؟)", "schema": { "type": "string" } }, { "name": "title_like", "in": "query", "description": "Partial match filter for title", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/alEmanBeAllah" }, { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/alEmanBeAllah" }, "pagination": { "$ref": "#/components/schemas/Pagination" } } } ] } } } }, "400": { "description": "Invalid query parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/alEmanBeAllah/_meta": { "get": { "summary": "Get alEmanBeAllah schema metadata", "description": "Returns schema metadata and sample data for the alEmanBeAllah endpoint.", "operationId": "getAlEmanBeAllahMeta", "tags": [ "Metadata" ], "responses": { "200": { "description": "Schema metadata with sample data", "content": { "application/json": { "schema": { "type": "object", "properties": { "endpoint": { "type": "string" }, "schema": { "type": "object" }, "sample_data": { "type": "object" } } } } } }, "404": { "description": "Endpoint not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/fatwaCategories": { "get": { "summary": "Get fatwaCategories data", "description": "Returns data from the fatwaCategories dataset with filtering, pagination, and field selection support.", "operationId": "getFatwaCategories", "tags": [ "Data" ], "parameters": [ { "$ref": "#/components/parameters/limitParam" }, { "$ref": "#/components/parameters/offsetParam" }, { "$ref": "#/components/parameters/fieldsParam" }, { "$ref": "#/components/parameters/sortParam" }, { "name": "id", "in": "query", "description": "Filter by id", "schema": { "type": "integer" } }, { "name": "title", "in": "query", "description": "Filter by title (e.g., العقيدة, الفقه)", "schema": { "type": "string" } }, { "name": "title_like", "in": "query", "description": "Partial match filter for title", "schema": { "type": "string" } }, { "name": "slug", "in": "query", "description": "Filter by slug (e.g., aqeedah, fiqh)", "schema": { "type": "string" } }, { "name": "slug_like", "in": "query", "description": "Partial match filter for slug", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/fatwaCategories" }, { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/fatwaCategories" }, "pagination": { "$ref": "#/components/schemas/Pagination" } } } ] } } } }, "400": { "description": "Invalid query parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/fatwaCategories/_meta": { "get": { "summary": "Get fatwaCategories schema metadata", "description": "Returns schema metadata and sample data for the fatwaCategories endpoint.", "operationId": "getFatwaCategoriesMeta", "tags": [ "Metadata" ], "responses": { "200": { "description": "Schema metadata with sample data", "content": { "application/json": { "schema": { "type": "object", "properties": { "endpoint": { "type": "string" }, "schema": { "type": "object" }, "sample_data": { "type": "object" } } } } } }, "404": { "description": "Endpoint not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/fatwaCategoriesMin": { "get": { "summary": "Get fatwaCategoriesMin data", "description": "Returns data from the fatwaCategoriesMin dataset with filtering, pagination, and field selection support.", "operationId": "getFatwaCategoriesMin", "tags": [ "Data" ], "parameters": [ { "$ref": "#/components/parameters/limitParam" }, { "$ref": "#/components/parameters/offsetParam" }, { "$ref": "#/components/parameters/fieldsParam" }, { "$ref": "#/components/parameters/sortParam" }, { "name": "id", "in": "query", "description": "Filter by id", "schema": { "type": "integer" } }, { "name": "title", "in": "query", "description": "Filter by title (e.g., العقيدة, الفقه وأصوله)", "schema": { "type": "string" } }, { "name": "title_like", "in": "query", "description": "Partial match filter for title", "schema": { "type": "string" } }, { "name": "slug", "in": "query", "description": "Filter by slug (e.g., aqeedah, fiqh)", "schema": { "type": "string" } }, { "name": "slug_like", "in": "query", "description": "Partial match filter for slug", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/fatwaCategoriesMin" }, { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/fatwaCategoriesMin" }, "pagination": { "$ref": "#/components/schemas/Pagination" } } } ] } } } }, "400": { "description": "Invalid query parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/fatwaCategoriesMin/_meta": { "get": { "summary": "Get fatwaCategoriesMin schema metadata", "description": "Returns schema metadata and sample data for the fatwaCategoriesMin endpoint.", "operationId": "getFatwaCategoriesMinMeta", "tags": [ "Metadata" ], "responses": { "200": { "description": "Schema metadata with sample data", "content": { "application/json": { "schema": { "type": "object", "properties": { "endpoint": { "type": "string" }, "schema": { "type": "object" }, "sample_data": { "type": "object" } } } } } }, "404": { "description": "Endpoint not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string", "description": "Error type" }, "message": { "type": "string", "description": "Human-readable error message" }, "details": { "type": "object", "description": "Additional error details" }, "suggestions": { "type": "object", "description": "Helpful hints for fixing the error" } }, "required": [ "error", "message" ] }, "Pagination": { "type": "object", "properties": { "total": { "type": "integer", "description": "Total number of items" }, "limit": { "type": "integer", "description": "Items per page" }, "offset": { "type": "integer", "description": "Number of items skipped" }, "hasMore": { "type": "boolean", "description": "Whether more items are available" } }, "required": [ "total", "limit", "offset", "hasMore" ] }, "44fth": { "type": "object", "properties": { "book_title_ar": { "type": "string" }, "author_ar": { "type": "string" }, "publisher_ar": { "type": "string" }, "booklet_url": { "type": "string" }, "introduction_ar": { "type": "string" }, "benefits": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": "1" }, "page_pdf": { "type": "integer", "example": "4" }, "title_short_ar": { "type": "string", "example": "تفاضل الأزمان بعضها على بعض" }, "text_ar": { "type": "string", "example": "فاضل الله تعالى بين مخلوقاته، ورفع بعضها على بعض درجات، ففضل بعض الأيام والشهور ..." }, "category_ar": { "type": "string", "example": "تفاضل الأزمان" }, "reference_ar": { "type": "string", "example": "تفاضل الأزمان بعضها على بعض (صوتيات) موقع سماحة الشيخ الإمام ابن باز)" }, "reference_url": { "type": "string", "example": "https://binbaz.org.sa/audios/1319/%D8%AA%D9%81%D8%A7%D9%84-%D8%A7%D9%84%D8%A7%D8..." }, "hashtag_ar": { "type": "string", "example": "#كنوز_العشر #ذي_الحجة" } }, "required": [ "id", "page_pdf", "title_short_ar", "text_ar", "category_ar", "reference_ar", "reference_url", "hashtag_ar" ] } }, "quiz_questions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "q1" }, "questionText": { "type": "string", "example": "ما هو أفضل أيام الدنيا كما ورد في كتيب الفوائد؟" }, "options": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "isCorrect": { "type": "boolean" } } }, "example": "[Array of 3 items]" }, "benefitId": { "type": "integer", "example": "3" } }, "required": [ "id", "questionText", "options", "benefitId" ] } }, "ui_strings": { "type": "object", "properties": { "metadata": { "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "booklet_url": { "type": "string" } } }, "appLogo": { "type": "object", "properties": { "title_ar": { "type": "string" }, "subtitle_en": { "type": "string" } } }, "nameInputPage": { "type": "object", "properties": { "welcomeTitle": { "type": "string" }, "welcomeDescription": { "type": "string" }, "nameLabel": { "type": "string" }, "namePlaceholder": { "type": "string" }, "startButton": { "type": "string" }, "footerText": { "type": "string" } } }, "appLayout": { "type": "object", "properties": { "pageTitleDefault": { "type": "string" }, "pageTitleLearnBenefit": { "type": "string" }, "pageTitleQuiz": { "type": "string" }, "pageTitleCertificate": { "type": "string" }, "footerBookReference": { "type": "string" }, "footerCopyright": { "type": "string" } } }, "learnPage": { "type": "object", "properties": { "loadingText": { "type": "string" }, "notFoundTitle": { "type": "string" }, "notFoundDescription": { "type": "string" }, "backToStartButton": { "type": "string" }, "shareSuccessToastTitle": { "type": "string" }, "linkCopiedToastTitle": { "type": "string" }, "linkCopiedToastDescription": { "type": "string" }, "shareFailedToastTitle": { "type": "string" }, "shareFailedToastDescription": { "type": "string" }, "shareButton": { "type": "string" }, "inviteButton": { "type": "string" }, "previousButton": { "type": "string" }, "nextButton": { "type": "string" }, "goToQuizButton": { "type": "string" }, "sourcePageInBook": { "type": "string" }, "homeButtonLabel": { "type": "string" }, "shareIntroTitle": { "type": "string" }, "shareIntroText": { "type": "string" }, "shareBenefitTitlePrefix": { "type": "string" }, "shareBenefitBaseText": { "type": "string" }, "shareDiscoverMoreText": { "type": "string" } } }, "quizPage": { "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "loadingText": { "type": "string" }, "questionXofY": { "type": "string" }, "submitButton": { "type": "string" }, "nextButton": { "type": "string" }, "previousButton": { "type": "string" }, "resultTitle": { "type": "string" }, "congratulationsName": { "type": "string" }, "passedMessage": { "type": "string" }, "failedMessage": { "type": "string" }, "viewCertificateButton": { "type": "string" }, "retryQuizButton": { "type": "string" }, "reviewLessonsButton": { "type": "string" }, "toastEnterNameFirst": { "type": "string" }, "toastCompleteLessonsFirst": { "type": "string" }, "toastQuizSuccessTitle": { "type": "string" }, "toastQuizSuccessDescription": { "type": "string" }, "toastQuizFailTitle": { "type": "string" }, "toastQuizFailDescription": { "type": "string" } } }, "certificatePage": { "type": "object", "properties": { "verifyingText": { "type": "string" }, "title": { "type": "string" }, "subtitle": { "type": "string" }, "bodyPart1": { "type": "string" }, "bodyPart2": { "type": "string" }, "dateLabel": { "type": "string" }, "sealText": { "type": "string" }, "downloadButton": { "type": "string" }, "downloadPreparingToastTitle": { "type": "string" }, "downloadPreparingToastDescription": { "type": "string" }, "reviewLessonsButton": { "type": "string" }, "inviteFriendButton": { "type": "string" }, "inviteFriendShareTitle": { "type": "string" }, "inviteFriendShareText": { "type": "string" }, "toastEnterNameFirst": { "type": "string" }, "toastPassQuizFirst": { "type": "string" } } } } }, "metadata": { "type": "object", "properties": { "bookletName": { "type": "string" }, "authorName": { "type": "string" }, "shareTemplate": { "type": "string" } } } } }, "AsmaaHusna": { "type": "object", "properties": { "title": { "type": "string" }, "source_document_info": { "type": "object", "properties": { "website": { "type": "string" }, "email": { "type": "string" }, "telegram": { "type": "string" }, "phone": { "type": "string" }, "social_media": { "type": "object", "properties": { "telegram_droplets": { "type": "string" }, "facebook": { "type": "string" }, "instagram": { "type": "string" }, "youtube": { "type": "string" } } } } }, "introduction": { "type": "object", "properties": { "main_text": { "type": "string" }, "quranic_verse": { "type": "object", "properties": { "text": { "type": "string" }, "citation": { "type": "string" } } }, "sunnah_hadith": { "type": "object", "properties": { "text": { "type": "string" }, "citation": { "type": "string" } } }, "sources": { "type": "array", "items": { "type": "string" } } } }, "preliminary_chapters": { "type": "array", "items": { "type": "object", "properties": { "chapter_title": { "type": "string", "example": "منزلة العلم بأسماء الله تعالى وصفاته" }, "points": { "type": "array", "items": { "type": "string" }, "example": "[Array of 12 items]" } }, "required": [ "chapter_title", "points" ] } }, "names": { "type": "array", "items": { "type": "object", "properties": { "number": { "type": "integer", "example": "1" }, "name_arabic": { "type": "string", "example": "الله" }, "knowledge_section": { "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "points": { "type": "array", "items": { "type": "object", "properties": { "point_title": { "type": "string" }, "sub_points": { "type": "array", "items": { "type": "string" } } } } } }, "example": "{Object}" }, "quran_references": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "citation": { "type": "string" } } }, "example": "[Array of 1 items]" }, "sunnah_references": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "citation": { "type": "string" } } }, "example": "[Array of 1 items]" }, "conduct_section": { "type": "object", "properties": { "title": { "type": "string" }, "points": { "type": "array", "items": { "type": "string" } } }, "example": "{Object}" } }, "required": [ "number", "name_arabic", "knowledge_section", "quran_references", "sunnah_references", "conduct_section" ] } }, "conclusionary_chapters": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "example": "أسماء الله ليست محصورة" }, "points": { "type": "array", "items": { "type": "string" }, "example": "[Array of 10 items]" } }, "required": [ "title", "points" ] } }, "final_message": { "type": "object", "properties": { "title": { "type": "string" }, "text": { "type": "string" } } } } }, "MenhajDareseen-p79p102": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": "1" }, "bloom_level": { "type": "string", "example": "Remembering" }, "question": { "type": "string", "example": "ما هو تعريف المد لغةً كما ورد في النص؟" }, "options": { "type": "array", "items": { "type": "string" }, "example": "[Array of 4 items]" }, "correct_answer": { "type": "integer", "example": "0" }, "explanation": { "type": "string", "example": "ورد في صفحة 79 أن المد لغة هو الزيادة والمط." } }, "required": [ "id", "bloom_level", "question", "options", "correct_answer", "explanation" ] } }, "alEmanBeAllah": { "type": "object", "properties": { "book_title": { "type": "string" }, "main_theme": { "type": "string" }, "introduction": { "type": "object", "properties": { "title": { "type": "string" }, "sections_overview": { "type": "array", "items": { "type": "string" } } } }, "chapters": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string", "example": "أولاً: هل عرفت الله حقاً؟" }, "pages": { "type": "array", "items": { "type": "object", "properties": { "page_number": { "type": "integer" }, "content": { "type": "array", "items": { "type": "string" } } } }, "example": "[Array of 5 items]" } }, "required": [ "title", "pages" ] } } } }, "fatwaCategories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": "1" }, "title": { "type": "string", "example": "العقيدة" }, "slug": { "type": "string", "example": "aqeedah" }, "sections": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "title": { "type": "string" }, "slug": { "type": "string" }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "title": { "type": "string" }, "slug": { "type": "string" } } } } } }, "example": "[Array of 10 items]" } }, "required": [ "id", "title", "slug", "sections" ] } }, "fatwaCategoriesMin": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": "1" }, "title": { "type": "string", "example": "العقيدة" }, "slug": { "type": "string", "example": "aqeedah" }, "sections": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "title": { "type": "string" }, "slug": { "type": "string" }, "topics": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "title": { "type": "string" }, "slug": { "type": "string" } } } } } }, "example": "[Array of 10 items]" } }, "required": [ "id", "title", "slug", "sections" ] } } }, "parameters": { "limitParam": { "name": "_limit", "in": "query", "description": "Maximum number of items to return (1-100, default: 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, "offsetParam": { "name": "_offset", "in": "query", "description": "Number of items to skip for pagination", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, "fieldsParam": { "name": "_fields", "in": "query", "description": "Comma-separated list of fields to include in response", "schema": { "type": "string" }, "example": "id,title_short_ar" }, "sortParam": { "name": "_sort", "in": "query", "description": "Field to sort by. Prefix with - for descending order", "schema": { "type": "string" }, "example": "-id" } } } }