{"openapi":"3.1.0","info":{"title":"API publique Danse Ici","version":"1.0.0","description":"Agenda des soirées, cours, stages et festivals de salsa, bachata et kizomba à Paris. Lecture seule, sans clé, CORS ouvert, réponses mises en cache 5 minutes. Les dates sont en heure de Paris."},"servers":[{"url":"https://www.danseici.fr"}],"paths":{"/api/v1/events":{"get":{"operationId":"searchEvents","summary":"Chercher des événements de danse","parameters":[{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Premier jour (AAAA-MM-JJ). Par défaut : aujourd'hui."},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Dernier jour inclus. Par défaut : from + 30 jours. Au plus 92 jours après from."},{"name":"dance","in":"query","schema":{"type":"string","enum":["salsa","bachata","kizomba"]}},{"name":"style","in":"query","schema":{"type":"string"},"description":"Style de danse (slug) : salsa-cubaine, salsa-portoricaine, bachata-dominicaine, bachata-sensuelle, urban-kiz…"},{"name":"format","in":"query","schema":{"type":"string","enum":["course","practice","workshop","festival","concert","dance_social","multi_event"]}},{"name":"city","in":"query","schema":{"type":"string","enum":["paris"],"default":"paris"}},{"name":"arrondissement","in":"query","schema":{"type":"string"},"description":"Numéro d'arrondissement (1 à 20) ou code postal 750xx."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Événements triés par date et heure.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]},"events":{"type":"array","items":{"$ref":"#/components/schemas/Event"}}}}}}},"400":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"503":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/events/{id}":{"get":{"operationId":"getEvent","summary":"Lire un événement","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"L'événement.","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"$ref":"#/components/schemas/Event"}}}}}},"404":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"503":{"description":"Erreur","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}},"components":{"schemas":{"Event":{"type":"object","required":["id","url","name","status","date","format","venue","price_summary","calendar_url"],"properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri","description":"Fiche publique de l'événement."},"name":{"type":"string"},"status":{"type":"string","enum":["scheduled","cancelled"]},"date":{"type":["string","null"],"format":"date","description":"Date locale (Europe/Paris)."},"start_time":{"type":["string","null"],"description":"Heure locale de début, HH:MM."},"end_time":{"type":["string","null"],"description":"Heure locale de fin, HH:MM."},"start_at":{"type":["string","null"],"format":"date-time"},"end_at":{"type":["string","null"],"format":"date-time"},"timezone":{"type":"string","example":"Europe/Paris"},"format":{"type":"object","properties":{"slug":{"type":["string","null"],"description":"course, practice, workshop, festival, concert, dance_social, multi_event"},"label":{"type":"string","example":"Soirée salsa"}}},"dances":{"type":"array","items":{"type":"object","properties":{"dance":{"type":"string","example":"salsa"},"dance_label":{"type":"string"},"style":{"type":["string","null"]},"style_label":{"type":["string","null"]}}}},"venue":{"type":"object","properties":{"name":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"address":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"area":{"type":["string","null"],"example":"Paris 11e"},"city":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}},"organizer":{"type":["object","null"],"properties":{"name":{"type":"string"},"url":{"type":["string","null"],"format":"uri"}}},"price_summary":{"type":"string","example":"Dès 10,00 €"},"prices":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"amount":{"type":["number","null"]},"currency":{"type":"string"}}}},"description":{"type":["string","null"]},"more_info_url":{"type":["string","null"],"format":"uri","description":"Lien de l'organisateur (réservation, page de l'événement)."},"calendar_url":{"type":"string","format":"uri","description":"Fichier iCalendar de l'événement."},"image_url":{"type":["string","null"],"format":"uri"}}}}}}