📡
API ya Umma ya REST
Fikia data yetu kupitia API
Base URL: https://swalaaxis.com/api/v1
📌 Majibu yote katika JSON. Mwisho nyingi ni za umma. Pita lang=ar kwa matokeo ya Kiarabu.
🕌 Maeneo
GET
/places
Orodhesha maeneo
| Vigezo | Aina | Maelezo |
|---|---|---|
country | string | Msimbo wa nchi (SA, IQ…) |
city | string | Slug ya jiji |
type | string | Aina ya eneo (msikiti, halali...) |
q | string | Swali la utafutaji |
limit | int | Idadi ya matokeo (upeo 100) |
offset | int | Kwa ukurasa |
GET
/place
Maelezo ya eneo moja
| Vigezo | Aina | Maelezo |
|---|---|---|
id * | int | Kitambulisho cha eneo |
POST
/review
Wasilisha mapitio
| Sehemu | Aina | Maelezo |
|---|---|---|
place_id * | int | |
rating * | int 1–5 | |
comment | string | Maandishi ya mapitio |
name | string | Jina la mpitia |
🕐 Nyakati za Sala
GET
/prayer
Nyakati za sala kwa mahali
| Vigezo | Aina | Maelezo |
|---|---|---|
lat * | float | Latitudo |
lng * | float | Longitudo |
method | int | Njia ya hesabu (1–23) |
school | 0|1 | 0=Shafi 1=Hanafi |
date | YYYY-MM-DD | Tarehe maalum (hiari) |
📅 Matukio
GET
/events
Orodhesha matukio
| Vigezo | Maelezo |
|---|---|
country | Msimbo wa nchi |
city | Slug ya jiji |
limit | max 50 |
🔍 Tafuta na Miji
GET
/search
Utafutaji wa pamoja
| Vigezo | Maelezo |
|---|---|
q * | Maandishi ya utafutaji |
country | Chuja kwa nchi |
GET
/cities
Orodhesha miji
| Vigezo | Maelezo |
|---|---|
country | Chuja kwa nchi |
💡 Majibu yote yana {"ok":true,"data":[...]} ikifanikiwa au {"ok":false,"error":"..."} ikishindwa.