Gerar link Arquivos para a Goalfy

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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.

⚠

Importante

O 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

CampoTipoDescrição
filePathStringURL pública do arquivo que será importado para a Goalfy.
filenameStringNome 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 200

Retorna uma URL válida para utilização do arquivo dentro da plataforma.


❗

Possíveis erros

400 Bad Request

Retornado quando o arquivo informado não possui uma URL válida ou algum campo obrigatório não foi enviado.

401 Unauthorized

Retornado quando o token de autenticação é inválido ou não foi enviado corretamente.

403 Forbidden

Retornado quando o usuário não possui permissão para utilizar o recurso.

404 Not Found

Retornado quando o arquivo informado não pôde ser localizado na URL fornecida.


Observações

🚧

Importante

O campo filePath deve 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 filename deve 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:

Headers
string
required
Defaults to "Token YOUR_TOKEN"
Response
200
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!