The Almeria Industries API Gateway Uploader is a RESTful HTTP API for secure file ingestion. It provides automatic content-type detection, SHA-256 integrity verification, and downstream queue-based processing to final destinations (AWS S3, Azure Blob Storage, or on-prem SFTP servers). This page documents the supported endpoints, authentication, and capabilities.

Server Identity

Property	Value
Protocol	HTTPS (REST API)
API Version	/v1
Max Upload Size	10 MB (configurable)
Rate Limiting	100 requests/sec, burst 120

Supported Endpoints

Method	Endpoint	Description
POST	/v1/upload-alm-pub	Upload a file to ApiGw instance. Requires JWT authorization. Returns SHA-256 hash, file name, file size, and detected content type.
POST	/v1/upload-alm-content-type-pub	Detect file content type without storing the file. Uses AI-powered scanner.
GET	/v1/uploader	Web UI form for file uploads.
GET	/v1/uploader-content-type	Web UI form for content-type detection.

Upload Request Format

File uploads use multipart/form-data with the following fields:

Field	Type	Required	Description
Authorization	string	Yes	JWT authorization token
Instance	string	Yes	API Gateway instance name
Name	string	Yes	File name
File	file	Yes	File to be uploaded (max 10 MB)

Upload Response

A successful upload returns the following fields:

Field	Type	Description
SHA256	string	SHA-256 hash of the uploaded file for integrity verification
FileName	string	Name of the uploaded file
FileSize	integer	Size of the uploaded file in bytes
ContentType	object	Detected MIME type, file extensions, and description

AI-Powered Content-Type Detection

• File content type is detected automatically using AI-powered scanner.
• Returns MIME type, file extensions, and a human-readable description.
• A standalone content-type detection endpoint (/v1/upload-alm-content-type-pub) is available for file type analysis without storage.

HTTP Status Codes

Code	Meaning
200	Request processed successfully
400	Invalid payload or missing required fields
401	Authorization token invalid or access key mismatch
404	Resource not found
413	File exceeds the maximum upload size (10 MB)
500	Internal server error
503	A dependency is unavailable (database, Vault, NATS)

Known Limitations

Limitation	Details
Ingress-only	The API Gateway supports file uploads only. File downloads are not available through this endpoint.
Max file size	Uploads are limited to 10 MB by default.
Concurrent content scans	AI-powered content-type detection is limited to four concurrent scans to prevent resource exhaustion.
Single file per request	Each upload request processes one file. Batch uploads require multiple requests.