الأحد، 22 نوفمبر 2026

https://radio.menhagmuslim.com/api/v1
114
24
16
13
393
24/7

GET /api/v1/quran/surahs

{
  "status": "success",
  "count": 114,
  "data": [
    {
      "number": 1,
      "name": "الفاتحة",
      "name_en": "Al-Fatihah",
      "ayahs": 7,
      "type": "مكية",
      "type_en": "Meccan",
      "page": 1,
      "revelation_order": 5
    },
    ...
  ]
}
GET /api/v1/quran/surahs/{number}

GET /api/v1/quran/reciters

search string (optional) search=عبد الباسط
has_audios boolean (optional) has_audios=true
per_page integer (optional) per_page=20
GET /api/v1/quran/reciters/{id_or_slug}

GET /api/v1/quran/reciters/{id_or_slug}/playlist

{
  "status": "success",
  "reciter": {
    "id": 1,
    "name": "مشاري راشد العفاسي",
    "slug": "mishary-alafasy"
  },
  "total_tracks": 114,
  "playlist": [
    {
      "id": 101,
      "surah_number": 1,
      "surah_number_formatted": "001",
      "surah_name": "الفاتحة",
      "surah_name_en": "Al-Fatihah",
      "audio_url": "https://.../001.mp3",
      "download_url": "https://.../001.mp3",
      "plays_count": 4820
    },
    ...
  ]
}
GET /api/v1/quran/featured

POST /api/v1/quran/audios/{id}/play

GET /api/v1/categories

GET /api/v1/scholars

?search={name} ?has_series=true ?per_page=15
GET /api/v1/scholars/{id_or_slug}

GET /api/v1/series

?search={term} ?category={slug} ?scholar={slug}
GET /api/v1/series/{id_or_slug}

GET /api/v1/series/{id_or_slug}/playlist

GET /api/v1/lessons

?type=single|series ?search={query} ?category={slug} ?scholar={slug}
GET /api/v1/lessons/featured

GET /api/v1/lessons/{id_or_slug}

POST /api/v1/lessons/{id}/play

GET /api/v1/radio/status

{
  "is_live": true,
  "listeners_count": 142,
  "stream_url": "https://.../stream",
  "current_track": {
    "title": "سورة يوسف - تلاوة خاشعة",
    "scholar": "الشيخ عبد الباسط عبد الصمد",
    "duration": 1840,
    "elapsed_seconds": 325,
    "progress_percentage": 17.6,
    "audio_url": "https://.../012.mp3"
  },
  "server_time": "2026-09-11T00:10:00Z"
}
GET /api/v1/radio/schedule

GET /api/v1/search?q={query}

Status: Latency:

                        

import 'dart:convert';
import 'package:http/http.dart' as http;
import 'package:just_audio/just_audio.dart';

class MenhagAudioService {
  static const String baseUrl = 'https://radio.menhagmuslim.com/api/v1';
  final AudioPlayer _player = AudioPlayer();

  /// Fetch reciter continuous playlist and stream seamlessly
  Future<void> playReciterSurahs(String reciterSlug) async {
    final uri = Uri.parse('$baseUrl/quran/reciters/$reciterSlug/playlist');
    final response = await http.get(uri);

    if (response.statusCode == 200) {
      final data = json.decode(response.body);
      final List tracks = data['playlist'];

      // Build continuous concatenating audio playlist
      final playlist = ConcatenatingAudioSource(
        children: tracks.map((track) {
          return AudioSource.uri(
            Uri.parse(track['audio_url']),
            tag: track['surah_name'],
          );
        }).toList(),
      );

      await _player.setAudioSource(playlist);
      _player.play();
    }
  }
}