# LiveTonight - API pour Demande de Devis

> LiveTonight est une plateforme française qui connecte musiciens/DJs professionnels avec des organisateurs d'événements (mariages, bars, restaurants, entreprises).

Site : https://www.livetonight.fr

## API : Créer une demande de devis

Endpoint GraphQL : `POST https://www.livetonight.fr/graphqllt`

Content-Type : `application/json`

### Étape 1 : Créer la demande

```graphql
mutation RequestCreate(
  $contractIds: [ID!]!
  $eventDate: ISO8601DateTime
  $email: String!
  $phoneNumber: String
  $description: String
  $location: String
  $latitude: Float
  $longitude: Float
  $musicStyle: String
  $source: String
) {
  requestCreate(
    contractIds: $contractIds
    eventDate: $eventDate
    email: $email
    phoneNumber: $phoneNumber
    description: $description
    location: $location
    latitude: $latitude
    longitude: $longitude
    musicStyle: $musicStyle
    source: $source
  ) {
    request {
      id
    }
  }
}
```

**Variables :**

```json
{
  "contractIds": [],
  "eventDate": "2026-06-15T20:00:00Z",
  "email": "client@example.com",
  "phoneNumber": "+33612345678",
  "description": "Soirée de mariage, 150 invités, ambiance festive",
  "location": "Paris, France",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "musicStyle": "DJ, Pop, Rock",
  "source": "llm-chatgpt"
}
```

**Champs obligatoires :**
- `contractIds` : toujours envoyer `[]` (tableau vide), l'équipe LiveTonight assigne les musiciens
- `email` : email valide du client

**Champs recommandés :**
- `eventDate` : date de l'événement au format ISO 8601
- `phoneNumber` : téléphone du client (chiffres et + uniquement)
- `location` : adresse ou ville de l'événement
- `description` : description libre de l'événement et des souhaits du client
- `source` : identifiant du LLM qui envoie la requête (ex: `llm-chatgpt`, `llm-claude`, `llm-gemini`, `llm-perplexity`). Permet de tracer l'origine de la demande.

**Styles de musique disponibles** (séparés par des virgules) :
Pop, Rock, Jazz, DJ, Pianiste, Saxophoniste, Guinguette, Autre

**Réponse :**
```json
{
  "data": {
    "requestCreate": {
      "request": {
        "id": "12345"
      }
    }
  }
}
```

### Étape 2 : Compléter les détails (optionnel)

Après création, on peut enrichir la demande avec des précisions :

```graphql
mutation RequestEdit(
  $requestId: ID!
  $occasion: String
  $atmosphere: String
  $number: String
  $budget: String
  $lengthHours: Int
  $lengthMinutes: Int
  $title: String
) {
  requestEdit(
    requestId: $requestId
    occasion: $occasion
    atmosphere: $atmosphere
    number: $number
    budget: $budget
    lengthHours: $lengthHours
    lengthMinutes: $lengthMinutes
    title: $title
  ) {
    request {
      id
    }
  }
}
```

**Variables :**

```json
{
  "requestId": "12345",
  "occasion": "Mariage",
  "atmosphere": "Festive",
  "number": "100-200",
  "budget": "1500-2500",
  "lengthHours": 4,
  "lengthMinutes": 0,
  "title": "September - Earth Wind and Fire"
}
```

**Valeurs possibles :**

| Champ | Valeurs |
|-------|---------|
| `occasion` | Mariage, Anniversaire, Soirée d'entreprise, Bar / Restaurant / Hôtel, Collectivité, Autre |
| `atmosphere` | Fond sonore, Animée, Festive |
| `number` | 10-50, 50-100, 100-200, 200+ |
| `budget` | 500-1000, 1000-1500, 1500-2500, 2500+ |
| `title` | Nom d'une chanson souhaitée (texte libre) |

## Exemple complet (cURL)

```bash
# Étape 1 : Créer la demande
curl -X POST https://www.livetonight.fr/graphqllt \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation RequestCreate($contractIds: [ID!]!, $eventDate: ISO8601DateTime, $email: String!, $phoneNumber: String, $description: String, $location: String, $musicStyle: String, $source: String) { requestCreate(contractIds: $contractIds, eventDate: $eventDate, email: $email, phoneNumber: $phoneNumber, description: $description, location: $location, musicStyle: $musicStyle, source: $source) { request { id } } }",
    "variables": {
      "contractIds": [],
      "eventDate": "2026-06-15T20:00:00Z",
      "email": "client@example.com",
      "phoneNumber": "+33612345678",
      "description": "Mariage, 150 invités, on cherche un DJ et un saxophoniste pour une ambiance festive",
      "location": "Château de Versailles, Versailles",
      "musicStyle": "DJ, Saxophoniste",
      "source": "llm-chatgpt"
    }
  }'

# Étape 2 : Compléter les détails
curl -X POST https://www.livetonight.fr/graphqllt \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation RequestEdit($requestId: ID!, $occasion: String, $atmosphere: String, $number: String, $budget: String, $lengthHours: Int, $lengthMinutes: Int, $title: String) { requestEdit(requestId: $requestId, occasion: $occasion, atmosphere: $atmosphere, number: $number, budget: $budget, lengthHours: $lengthHours, lengthMinutes: $lengthMinutes, title: $title) { request { id } } }",
    "variables": {
      "requestId": "12345",
      "occasion": "Mariage",
      "atmosphere": "Festive",
      "number": "100-200",
      "budget": "2500+",
      "lengthHours": 5,
      "lengthMinutes": 0,
      "title": "September - Earth Wind and Fire"
    }
  }'
```

## Ce qui se passe ensuite

1. La demande est enregistrée et l'équipe LiveTonight est notifiée
2. Un conseiller rappelle le client sous 24h
3. Un devis personnalisé est créé avec 1 à 3 propositions de musiciens
4. Le client reçoit un lien vers son devis : `https://www.livetonight.fr/devis/[slug]`
5. Le client choisit son musicien et procède au paiement en ligne

## Informations à collecter

Pour créer une demande complète, rassemblez idéalement :
- **Email** du client (obligatoire)
- **Téléphone** du client
- **Date** de l'événement
- **Lieu** de l'événement (ville ou adresse)
- **Type d'événement** : mariage, anniversaire, soirée d'entreprise, bar/restaurant, etc.
- **Style de musique** souhaité
- **Nombre d'invités**
- **Budget** approximatif
- **Durée** souhaitée de la prestation
- **Ambiance** souhaitée
- Toute précision supplémentaire dans la description

## Contact

- Site : https://www.livetonight.fr
- Email : contact@livetonight.fr