API Wakafrica — ressources développeurs

L'API publique Wakafrica expose le catalogue des programmes immobiliers publiés sur UrbAfrica ainsi que l'authentification des applications mobiles Wakafrica.

• URL de base : https://wakafrica.com/api
• Spécification OpenAPI 3.1 : https://wakafrica.com/openapi.json
• Index pour agents : https://wakafrica.com/llms.txt
• Plan du site : https://wakafrica.com/sitemap.xml
• Contact technique : https://wakafrica.com/contact

Authentification

Les points d'entrée publics ne demandent aucune authentification. Les points d'entrée privés utilisent un jeton porteur Laravel Sanctum :

Authorization: Bearer <token>

Le jeton est obtenu via POST /api/auth/login (email, password) ou POST /api/auth/register (name, email, password, password_confirmation). POST /api/auth/logout révoque le jeton courant, GET /api/auth/me renvoie le profil de l'utilisateur authentifié.

Points d'entrée publics

GET /api/v1/urbafrica/programs

Liste les programmes immobiliers publiés et publics. Réponse : { "programs": [...], "featured": [...] }. Chaque programme porte son identifiant, son titre, son slug, sa description, son type, son objectif de financement, le nombre de lots disponibles, ses localisations et ses médias.

GET /api/v1/urbafrica/programs/{id}

Détail d'un programme publié : { "program": {...}, "properties": [...], "projects": [...] }. Les prix des lots ne sont renvoyés qu'aux appelants authentifiés.

Conventions

• Toutes les réponses sont en JSON UTF-8.
• Les montants sont exprimés dans la devise du pays du programme (XAF au Cameroun).
• Un identifiant inconnu renvoie un statut HTTP 404.
• Les erreurs de validation renvoient un statut 422 au format Laravel ({ "message": ..., "errors": { "champ": ["..."] } }).

Négociation de contenu markdown

Les pages publiques répondent en text/markdown; charset=utf-8 lorsqu'un client envoie Accept: text/markdown (convention acceptmarkdown.com). Ces réponses portent l'en-tête Vary: Accept.

curl -H "Accept: text/markdown" https://wakafrica.com/