Sesiones de subida

Crear una sesión

Cree una sesión especificando qué destinos deben recibir las imágenes subidas. Si omite destination_ids, se utilizan los destinos predeterminados de la clave API.

Cuerpo de la solicitud

curl -X POST https://api.apertur.ca/api/v1/upload-sessions \
  -H "Authorization: Bearer aptr_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_ids": [
      "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "7c9e6679-7425-40de-944b-e07fc1f90ae7"
    ],
    "tags": ["user:123", "order:456"],
    "expires_in_hours": 24,
    "max_images": 10
  }'

Destinos

Los destinos son objetivos de entrega preconfigurados administrados en su panel de control bajo Proyecto → Destinos. Apertur admite 9 tipos de destinos en cuatro categorías.

Almacenamiento en la nube

Unidades en la nube

Servidor

HTTP

Administración de destinos

Administre los destinos a través de la API o del panel de control bajo Proyecto → Destinos.

Los destinos basados en OAuth (google_drive, dropbox, onedrive, box) se crean a través de un flujo de autorización OAuth iniciado desde el panel de control.

Long polling

Long polling es una opción boolean en la sesión, no un tipo de destino. Cuando está habilitada, su servidor puede consultar las imágenes junto con cualquier destino push. Esto es útil cuando su servidor no puede aceptar solicitudes entrantes. Consulte la documentación de Long Polling para más detalles.

{
  "destination_ids": ["d290f1ee-..."],
  "long_polling": true
}

Respuesta

La respuesta incluye un uuid para identificar la sesión y la lista de destinos resueltos.

{
  "uuid": "sess_01HX4ABCDEFGHIJKLMN",
  "destinations": [
    { "id": "d290f1ee-...", "type": "s3", "name": "Production S3" },
    { "id": "7c9e6679-...", "type": "webhook", "name": "My Webhook" }
  ],
  "long_polling": false,
  "expires_at": "2024-03-29T10:00:00Z",
  "password_protected": false
}

Estado de entrega

Rastree el progreso de entrega por imagen y por destino para cualquier sesión.

curl https://api.apertur.ca/api/v1/upload-sessions/sess_01HX4ABCDEFGHIJKLMN/delivery-status \
  -H "Authorization: Bearer aptr_xxxx"

{
  "session_id": "sess_01HX4ABCDEFGHIJKLMN",
  "images": [
    {
      "image_id": "img_01HX...",
      "image_index": 0,
      "deliveries": [
        {
          "destination_id": "d290f1ee-...",
          "destination_name": "Production S3",
          "destination_type": "s3",
          "status": "delivered",
          "delivered_at": "2024-03-28T10:01:23Z"
        },
        {
          "destination_id": "7c9e6679-...",
          "destination_name": "My Webhook",
          "destination_type": "webhook",
          "status": "pending",
          "attempts": 1,
          "next_retry_at": "2024-03-28T10:02:00Z"
        }
      ]
    }
  ]
}

Opciones de sesión

Estos campos opcionales le permiten personalizar el comportamiento de la sesión.

Estado de la sesión