RyeSprint Quranic Guidance
Seeking answers through the divine wisdom of the Holy Quran
POST /guidance
Ask questions and receive answers based on Quranic teachings
Interactive UI
Use our web interface to ask questions without writing code
Rate Limiting
5 requests per day per IP address with automatic daily reset
Rate Limiting
Each IP address is limited to 5 requests per day. The limit automatically resets after 24 hours. No API key is required.
Check your remaining requests at any time with GET /api/rate-limit-info.
Endpoints
Ask for Guidance
POST /api/guidance
Submit a question to receive guidance based on Quranic teachings.
Request Body
{ "question": "Your question here" }
Example Request
curl -X POST https://quran.rspt.se/api/guidance \ -H "Content-Type:
application/json" \ -d '{"question":"Is charity encouraged in
Islam?"}'
Example Response
{ "answer": "Yes, charity (sadaqah and zakat) is highly encouraged...",
"guidance": "aligned", "references": [ { "surah": "Al-Baqarah", "ayah":
"261", "text": "The example of those who spend their wealth in the way
of Allah..." } ], "requests_left": 4 }
Response Fields
- answer — The detailed answer based on Quranic teachings
-
guidance — One of three possible
values:
- "aligned" — The question/action is in accordance with Islamic principles
- "misaligned" — The question/action contradicts Islamic principles
- "unrelated" — The question is not related to the Quran or Islamic guidance
- references — Array of Quranic references with surah, ayah, and verse text
- requests_left — Number of remaining requests for today
How It Works
- Submit your question via POST request
- The AI provides an answer based on Quranic teachings
- Receive guidance with detailed reasoning and Quranic references
- Responses are stored locally in your browser's localStorage