| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Gera um link temporário de arquivo para utilização em campos do tipo arquivo na plataforma.
Este endpoint permite registrar arquivos externos no armazenamento da Goalfy, retornando uma URL que poderá ser utilizada posteriormente em campos de upload, formulários, cards ou registros.
É recomendado para integrações que necessitam enviar arquivos para a plataforma de forma automatizada, sem a necessidade de realizar uploads manuais.
ImportanteO arquivo informado deve estar acessível através de uma URL pública para que a Goalfy possa realizar o processamento e armazenamento.
Campos utilizados no Body
| Campo | Tipo | Descrição |
|---|---|---|
filePath | String | URL pública do arquivo que será importado para a Goalfy. |
filename | String | Nome do arquivo incluindo sua extensão. |
Body da Requisição
{
"filePath": "https://system.com.br/arquivos/documento.pdf",
"filename": "documento.pdf"
}Exemplo de Resposta
{
"url":"https://storage.goalfy.com.br/files/..."
}
Respostas esperadas
Sucesso 200Retorna uma URL válida para utilização do arquivo dentro da plataforma.
Possíveis erros
400 Bad RequestRetornado quando o arquivo informado não possui uma URL válida ou algum campo obrigatório não foi enviado.
401 UnauthorizedRetornado quando o token de autenticação é inválido ou não foi enviado corretamente.
403 ForbiddenRetornado quando o usuário não possui permissão para utilizar o recurso.
404 Not FoundRetornado quando o arquivo informado não pôde ser localizado na URL fornecida.
Observações
ImportanteO campo
filePathdeve conter uma URL pública acessível pela Goalfy.
- O arquivo informado deve estar disponível para download sem necessidade de autenticação.
- O campo
filenamedeve conter a extensão correta do arquivo.- O link retornado deverá ser utilizado posteriormente em campos do tipo arquivo.
- Arquivos indisponíveis ou bloqueados por autenticação poderão impedir o processamento da requisição.
- Recomenda-se validar a disponibilidade do arquivo antes de realizar o envio.
FAQ?
Perguntas frequentes que fazem.
Segue abaixo cards que podem te ajudar a tirar essas dúvidas:
200