API EventPics
A API permite carregar fotos automaticamente para um álbum EventPics, por exemplo a partir de um photobooth.
Chave da API
Obtenha a sua chave pessoal na app ou Web App EventPics. Abra o seu evento e aceda à gestão de chaves API.
A API permite carregar fotos automaticamente para um álbum EventPics, por exemplo a partir de um photobooth.
Obtenha a sua chave pessoal na app ou Web App EventPics. Abra o seu evento e aceda à gestão de chaves API.
Os seguintes endpoints estão disponíveis para integrações. Todas as requisições exigem a sua chave API. Para geteventsandalbums envie a chave no cabeçalho (recomendado: Authorization: Bearer <API_KEY>, alternativa X-API-Key: <API_KEY>); para os endpoints de upload envie-a no corpo JSON.
POST Pedir URL de upload
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 millisecondsResposta
uploadUrl: string (URL pré-assinado, válido 30 minutos)mediaUrl: string (página com esta única foto ou vídeo, curta para um código QR)downloadUrl: string (o ficheiro em si na CDN de media)GET Obter eventos e álbuns
https://api.event.pics/geteventsandalbums
Autenticação
Authorization: Bearer YOUR_API_KEY (recommended)X-API-Key: YOUR_API_KEYResposta
events: array of objects with title, linkId, albumsComo funciona o fluxo de upload. A uploadUrl é válida por cerca de 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)