Gerar URL de upload de arquivo para análise AG-IA

POST

/v2/files/clients/{clientId}/ag-ia-upload

Gera uma URL assinada para enviar um arquivo ao armazenamento usado pela análise AG-IA. A API não recebe o arquivo: informe o tamanho em bytes e o tipo MIME, e use a signedUrl devolvida para enviar o arquivo diretamente ao armazenamento. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

URL assinada para envio do arquivo

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Campos inválidos

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/files/clients//ag-ia-upload' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "fileSize": 204800,
    "mimeType": "application/pdf"
}'

Response Example

200 - Sucesso

{
    "signedUrl": "https://storage.example.com/ag-ia/upload/signed?token=abc"
}

Modificado em 2026-10-13 09:47:06

Página anterior

Listar culturas

Próxima página

Gerar URL de download de arquivo da análise AG-IA