API de EventPics
La API te permite subir fotos automáticamente a un álbum de EventPics, por ejemplo desde un fotomatón.
Clave de API
Obtén tu clave personal en la app o web app de EventPics. Abre tu evento y entra en la gestión de claves API.
La API te permite subir fotos automáticamente a un álbum de EventPics, por ejemplo desde un fotomatón.
Obtén tu clave personal en la app o web app de EventPics. Abre tu evento y entra en la gestión de claves API.
Estos endpoints están disponibles para integraciones. Todas las peticiones requieren tu clave API. Para geteventsandalbums envía la clave en la cabecera (recomendado: Authorization: Bearer <API_KEY>, alternativa X-API-Key: <API_KEY>); para los endpoints de subida envíala en el cuerpo JSON.
POST Solicitar URL de subida
https://api.event.pics/getuploadurl
Parámetros (JSON)
apiKey: string (required)linkId: string (required)albumId: string (optional)fileName: string (required)takenAt: number (optional) – Unix timestamp in millisecondsRespuesta
uploadUrl: string (URL prefirmada, válida 30 minutos)mediaUrl: string (página con esta única foto o vídeo, corta para un código QR)downloadUrl: string (el archivo en la CDN de medios)GET Obtener eventos y álbumes
https://api.event.pics/geteventsandalbums
Autenticación
Authorization: Bearer YOUR_API_KEY (recommended)X-API-Key: YOUR_API_KEYRespuesta
events: array of objects with title, linkId, albumsCómo funciona el flujo de subida. La uploadUrl es válida durante unos 30 minutos.
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)