Subida Manual

Obtener url pre-firmada

POST https://gateway.increase.app/card/v2/files/upload_link

Headers

Content-Type: application/json
Authorization: Bearer <access_token>
Tenant: <país>

curl --include \
     --header "Content-Type: application/json" \
     --header "Tenant: argentina" \
     --header "X-Auth-Token: <tu_access_token>" \
  'https://gateway.increase.app/card/v2/files/upload_link'

### Parámetros	Tipo	Descripción
filename	String	Nombre del archivo a subir

Success response

{
    "url": "[REDACTED]",
    "key": "argentina/00000000-0000-0000-0000-00000000488b/00000000-0000-0000-0000-000000004e4d/2025/04/22/164822_test.txt",
    "Content-Type": "multipart/form-data",
    "Expires": "Tue, 22 Apr 2025 20:18:22 GMT",
    "acl": "private",
    "policy": "[REDACTED]",
    "x-amz-credential": "[REDACTED]",
    "x-amz-algorithm": "AWS4-HMAC-SHA256",
    "x-amz-date": "20250422T194822Z",
    "x-amz-security-token": "[REDACTED]",
    "x-amz-signature": "[REDACTED]"
}

Subir archivo a S3

POST <URL devuelta por el endpoint de la URL prefirmada>

La URL a la que se realiza este POST es dinámica y se obtiene del campo "url" en la respuesta del endpoint para la URL prefirmada.

Headers

Content-Type: <valor de responseUrlPreFirmada["Content-Type"]>
Content-Disposition: attachment; filename=<nombre del archivo normalizado>

### Parámetros	Tipo	Descripción	Fuente (responseUrlPreFirmada)
key	String	La ruta del objeto que se creará en el bucket de S3. Incluye la estructura de carpetas y el nombre del archivo generado.	responseUrlPreFirmada.key
x-amz-credential	String	Credencial de AWS para autenticar la petición. Incluye el ID de la clave de acceso, la fecha, la región, el servicio (s3) y el tipo de solicitud (aws4_request).	responseUrlPreFirmada.x-amz-credential
x-amz-date	String	Fecha y hora de la petición en formato ISO 8601 (YYYYMMDDTHHMMSSZ).	responseUrlPreFirmada.x-amz-date
x-amz-signature	String	Firma de la petición, calculada utilizando el algoritmo HMAC-SHA256 y la clave secreta de AWS.	responseUrlPreFirmada.x-amz-signature
x-amz-algorithm	String	El algoritmo de firma utilizado (generalmente AWS4-HMAC-SHA256).	responseUrlPreFirmada.x-amz-algorithm
acl	String	Access Control List para el objeto subido (en este caso, "private"). Define quién tiene permisos para acceder al archivo.	responseUrlPreFirmada.acl
x-amz-security-token	String	Token de seguridad temporal, requerido si se utilizan roles de IAM o credenciales temporales. Puede estar ausente.	responseUrlPreFirmada.x-amz-security-token
policy	String	Documento JSON que define las condiciones bajo las cuales la petición es válida. Incluye la expiración, bucket, clave, tipo de contenido, etc.	responseUrlPreFirmada.policy
Expires	String	Fecha y hora de expiración de la URL prefirmada en formato GMT.	responseUrlPreFirmada.Expires
Content-Type	String	El tipo de contenido del archivo que se está subiendo (ej: image/jpeg, application/pdf, multipart/form-data).	responseUrlPreFirmada["Content-Type"]
file	File	El archivo que se va a subir (objeto File).	(Objeto File local)

Obtener el listado de documentos subidos

GET https://gateway.increase.app/card/v2/files/manual_uploads

Headers

Content-Type: application/json
Authorization: Bearer <access_token>
Tenant: <país>

### Parámetros	Tipo	Descripción
page	Integer	Indica la página a obtener
per_page	Integer	Cantidad de resultados por página (Máximo 40)

Success response

{
    "documents": [
        {
            "created_at": "2025-04-21",
            "filename": "165350_test.txt",
            "info_provider": null,
            "status": "failed",
            "detail_message": "No pudimos procesar el documento. Contáctanos."
        },
        {
            "created_at": "2024-08-26",
            "filename": "171839_30000test-27-08-2024.txt",
            "info_provider": "first_data_new",
            "status": "ok",
            "detail_message": "Ya puedes ver tu información."
        }
    ],
    "current_page": 1,
    "per_page": 25,
    "total_pages": 2,
    "total_elements": 46
}