# KatiCash API Documentation

## 🎯 Public Poll Detail Endpoint

### Accès à un poll public

Vous pouvez accéder à un poll public directement via son URL unique:

```
/poll/[pollId]
```

### Exemple

Pour voir le détail du poll avec l'ID `7649d212-0f9c-4e8c-859a-f0f5b1285493`, accédez à:

```
https://katicash.com/poll/7649d212-0f9c-4e8c-859a-f0f5b1285493
```

### API Backend (en développement)

L'endpoint API public retourne les données du poll au format JSON:

```
GET https://api.katicash.com/polls/detail/public/{pollId}
```

### Réponse Succès (HTTP 200)

```json
{
  "success": true,
  "message": "Public poll details retrieved successfully",
  "data": {
    "id": "7649d212-0f9c-4e8c-859a-f0f5b1285493",
    "title": "Qui gagnera la finale de la CAN 2025 ?",
    "description": "Pronostic sur le match final au Maroc.",
    "type": "YES_NO",
    "status": "ACTIVE",
    "images": ["https://..."],
    "initial_stake": 1000,
    "total_pool_yes": 15000,
    "total_pool_no": 8500,
    "is_private": false,
    "country_code": "CM",
    "created_at": "2024-04-17T12:00:00.000Z",
    "date_fin_paris": "2025-02-15T23:59:59.000Z",
    "creator": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "username": "paul_k",
      "profile_image": "https://...",
      "reputation": 150
    },
    "category": {
      "id": "cat-sports-001",
      "name": "Sports",
      "description": "Football, Basketball, etc."
    },
    "bets": [
      {
        "id": "bet-999",
        "amount": "5000",
        "choice": "YES",
        "status": "ACTIVE",
        "current_potential_gain": 2450.5,
        "user": {
          "id": "user-456",
          "username": "gamer_tz"
        }
      }
    ]
  }
}
```

### Réponse Erreur (HTTP 404)

Si le poll n'existe pas ou est marqué comme privé:

```json
{
  "success": false,
  "message": "Poll with ID ... not found or is private",
  "error": "Not Found",
  "statusCode": 404
}
```

## 📱 Fonctionnalités Frontend

### Page de détail du poll

La page `/poll/[id]` affiche:

- ✅ Titre et description du poll
- ✅ Image associée
- ✅ Créateur et réputation (Karma)
- ✅ Statistiques en temps réel (OUI/NON)
- ✅ Pool de mises totales
- ✅ Règles du jeu (frais, pénalité, consensus)
- ✅ Listes des mises récentes
- ✅ Bouton "Participer" qui dirige vers l'app mobile

### Détection du device

Au clic sur "Participer":
- **Android** → Redirection vers Google Play Store
- **iOS** → Redirection vers App Store

## 🔗 Liens utiles

- **Exemple de poll**: `/poll/7649d212-0f9c-4e8c-859a-f0f5b1285493`
- **Accueil**: `/`
- **CGU**: `/cgu`
- **Confidentialité**: `/privacy`