Destinos

Webhook

Los webhooks son el metodo de entrega mas comun. Apertur envia una solicitud HTTP POST a su URL con los datos de la foto tan pronto como se sube cada imagen.

1. Establezca delivery_mode en "webhook" al crear una sesion.
2. Proporcione la URL de su endpoint en el parametro webhook_url.
3. Opcionalmente elija un formato: json_base64 (predeterminado) o multipart.
4. Su endpoint debe responder con un codigo de estado 2xx dentro de los 30 segundos.
5. Si la entrega falla, Apertur reintenta con retroceso exponencial hasta 5 veces.

curl -X POST https://api.apertur.ca/v1/sessions \
  -H "Authorization: Bearer aptr_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "delivery_mode": "webhook",
    "webhook_url": "https://your-app.com/api/photos",
    "webhook_format": "json_base64"
  }'

Para configuracion avanzada incluyendo encabezados personalizados y verificacion de firmas, consulte la documentacion de webhooks.

Amazon S3

Entregue fotos directamente a un bucket de Amazon S3. Ideal para flujos de trabajo que procesan imagenes desde S3 usando Lambda u otros servicios en la nube.

1. Navegue a Configuracion del proyecto > Destinos y agregue un nuevo destino S3.
2. Ingrese el nombre del bucket, la region y las credenciales (access key ID y secret).
3. Opcionalmente configure una plantilla de clave para rutas de archivo personalizadas.
4. Pruebe la conexion para verificar que Apertur pueda escribir en su bucket.
5. Al crear sesiones, establezca delivery_mode en s3 y haga referencia a este destino.
6. Haga clic en Guardar para finalizar.

// Example destination config (via API)
{
  "type": "s3",
  "bucket": "my-photos-bucket",
  "region": "us-east-1",
  "access_key_id": "AKIA...",
  "secret_access_key": "wJal...",
  "key_template": "uploads/{session_id}/{image_index}.{ext}"
}

Google Drive

Entregue fotos a una carpeta de Google Drive. Ideal para equipos que ya usan Google Workspace para colaboracion.

1. Vaya a Configuracion del proyecto > Destinos y agregue un destino de Google Drive.
2. Haga clic en Conectar cuenta de Google para autorizar a Apertur mediante OAuth.
3. Seleccione la carpeta de destino (o deje que Apertur cree una).
4. Opcionalmente configure una plantilla de subcarpeta usando variables de sesion.
5. Haga clic en Guardar. Las fotos se entregaran en la carpeta seleccionada.

Apertur solicita unicamente los permisos minimos necesarios para escribir archivos en su Drive. Puede revocar el acceso en cualquier momento desde la configuracion de su cuenta de Google.

Dropbox

Entregue fotos a una carpeta de Dropbox. Util para flujos de trabajo que dependen de Dropbox para compartir y almacenar archivos.

1. Navegue a Configuracion del proyecto > Destinos y agregue un destino de Dropbox.
2. Haga clic en Conectar Dropbox para autorizar mediante OAuth.
3. Elija la ruta de carpeta de destino.
4. Opcionalmente configure una plantilla de subcarpeta.
5. Haga clic en Guardar para finalizar la configuracion.

help.destinations.dropboxNote

OneDrive

Entregue fotos a una carpeta de OneDrive. Funciona tanto con cuentas personales como con OneDrive para Empresas.

1. Vaya a Configuracion del proyecto > Destinos y agregue un destino de OneDrive.
2. Haga clic en Conectar cuenta de Microsoft para autorizar mediante OAuth.
3. Seleccione la carpeta de destino o ingrese una ruta personalizada.
4. Opcionalmente configure una plantilla de subcarpeta.
5. Haga clic en Guardar para completar la configuracion.

OneDrive para Empresas puede requerir el consentimiento del administrador en su inquilino de Microsoft 365 antes de conectarse.

FTP / SFTP

Entregue fotos a un servidor FTP o SFTP. Comunmente utilizado en entornos empresariales e integraciones heredadas.

1. Navegue a Configuracion del proyecto > Destinos y agregue un destino FTP/SFTP.
2. Ingrese el host, puerto, nombre de usuario y contrasena de su servidor (o clave SSH para SFTP).
3. Especifique la ruta del directorio remoto donde se deben subir las fotos.
4. Pruebe la conexion para asegurarse de que Apertur pueda autenticarse y escribir archivos.
5. Haga clic en Guardar para finalizar.

Azure Blob Storage

Entregue fotos a un contenedor de Azure Blob Storage. Funciona bien con Azure Functions, Logic Apps y otros servicios de Azure.

1. Vaya a Configuracion del proyecto > Destinos y agregue un destino de Azure Blob.
2. Ingrese el nombre de la cuenta de almacenamiento, el nombre del contenedor y el token SAS (o cadena de conexion).
3. Opcionalmente configure una plantilla de ruta de blob.
4. Pruebe la conexion para verificar el acceso de escritura.
5. Haga clic en Guardar para finalizar.

// Example destination config (via API)
{
  "type": "azure_blob",
  "account_name": "mystorageaccount",
  "container_name": "photos",
  "sas_token": "sv=2023-01-03&st=...",
  "blob_template": "uploads/{session_id}/{image_index}.{ext}"
}

WebDAV

Entregue fotos a cualquier servidor compatible con WebDAV. Admite Nextcloud, ownCloud y otras implementaciones de WebDAV.

1. Navegue a Configuracion del proyecto > Destinos y agregue un destino WebDAV.
2. Ingrese la URL del servidor, el nombre de usuario y la contrasena.
3. Especifique la ruta del directorio remoto.
4. Pruebe la conexion para asegurarse de que Apertur pueda escribir archivos.
5. Haga clic en Guardar para finalizar.

Asegurese de que su servidor WebDAV admita el metodo PUT y que el directorio de destino exista.

Probar su destino

Antes de usar un destino en produccion, le recomendamos probarlo con una sesion de ejemplo.

1. Cree una sesion usando una API key de prueba.
2. Establezca max_images en 1 para una prueba rapida.
3. Escanee el QR code y suba una foto de prueba.
4. Verifique que la foto llego a su destino.