L'API permet de téléverser automatiquement des photos dans un album EventPics, par exemple depuis un photobooth.
Obtenez votre clé personnelle dans l'app ou la Web App EventPics. Ouvrez votre événement et accédez à la gestion des clés API.
Les endpoints suivants sont disponibles pour les intégrations. Toutes les requêtes nécessitent votre clé API. Pour geteventsandalbums, envoyez la clé dans l'en-tête (recommandé : Authorization: Bearer <API_KEY>, alternative X-API-Key: <API_KEY>) ; pour les endpoints d'envoi, envoyez-la dans le corps JSON.
POST Demander l'URL d'envoi
https://api.event.pics/getuploadurl
Paramètres (JSON)
apiKey: string (required)linkId: string (required)albumId: string (optional)fileName: string (required)takenAt: number (optional) – Unix timestamp in millisecondsRéponse
uploadUrl: string (URL présignée, valable 30 minutes)mediaUrl: string (page affichant cette seule photo ou vidéo, assez courte pour un QR code)downloadUrl: string (le fichier lui-même sur le CDN média)GET Récupérer événements et albums
https://api.event.pics/geteventsandalbums
Authentification
Authorization: Bearer YOUR_API_KEY (recommended)X-API-Key: YOUR_API_KEYRéponse
events: array of objects with title, linkId, albumsFonctionnement du flux d'envoi. L'uploadUrl est valable environ 30 minutes.
GET https://api.event.pics/geteventsandalbums
Authorization: Bearer YOUR_API_KEY (or X-API-Key){
"Authorization": "Bearer YOUR_API_KEY"
}{
"events": [
{
"title": "My Event",
"linkId": "EVENT_LINK_ID",
"albums": [
{ "title": "Album name", "albumId": "ALBUM_ID" }
]
}
]
}POST https://api.event.pics/getuploadurl
{
"apiKey": "YOUR_API_KEY",
"linkId": "EVENT_LINK_ID",
"albumId": "ALBUM_ID",
"fileName": "photo.jpg",
"takenAt": 1712345678901,
}{
"uploadUrl": "https://eventpics...r2.cloudflarestorage.com/...",
"mediaUrl": "https://event.pics/m/ye8Itau4wi6Vbj1DydRiWw08q7v4",
"downloadUrl": "https://media.event.pics/62988d.../1789071999558o"
}PUT uploadUrl
PUT {{uploadUrl}}
Content-Type: image/jpeg
(binary file content)