API de mídiaAPI

Envie uma vez, publique em qualquer lugar

Envie um arquivo para a biblioteca de mídia e receba um id. Anexe esse id a quantos posts quiser e FoPost converte e entrega no formato que cada rede exige. O armazenamento é privado e restrito ao espaço de trabalho.

Obtenha sua chave de APILer a documentação
POST /v1/media/upload
curl -X POST "https://api.fopost.com/v1/media/upload?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY" \
  -F "[email protected]"

{
  "data": [
    {
      "id": "e5a1c9d4-...",
      "type": "image",
      "name": "launch.png",
      "url": "https://.../launch.png",
      "preview_url": "https://api.fopost.com/v1/media/e5a1c9d4-.../file",
      "size": 412883
    }
  ]
}

Upload multipart

Imagens e vídeos de até 50 MB, validados pelo conteúdo, não só pela extensão.

Reutilize por id

Um upload, quantos posts quiser. O arquivo nunca é enviado duas vezes.

Privado por padrão

Os arquivos ficam em armazenamento privado e são servidos apenas a membros do espaço de trabalho.

Upload

Uma só entrada, verificada na chegada

Todo arquivo passa pelo mesmo caminho: lista de MIME permitidos, verificação dos bytes reais, limite de tamanho e a franquia gratuita de armazenamento da sua conta. O resultado é um item da biblioteca com tipo e tamanho, pronto para anexar.

Ler a referência de mídia
Anexar a um post
curl -X POST https://api.fopost.com/v1/posts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "content": [{ "text": "Launch day.", "media": [{ "type": "image", "name": "launch.png", "url": "https://.../launch.png" }] }],
    "accounts": ["4a71d80b-..."]
  }'

Imagens

PNG, JPEG, GIF e WebP, com tipo e tamanho lidos no upload.

Vídeo

MP4 e MOV, com duração e tamanho verificados para cada rede no momento da publicação.

Validado

O conteúdo real do arquivo precisa corresponder ao tipo, ou o upload é rejeitado.

Entrega

O formato certo para cada rede, sem esforço seu

As redes divergem em proporções, tamanhos e codecs. No momento da publicação, cada adaptador pega o original armazenado e envia o que aquela plataforma aceita, então um único item da biblioteca funciona em um carrossel, uma thread ou um feed de vídeos curtos.

Ver como funciona a entrega
Imagens da marca organizadas na biblioteca de mídia compartilhada

Regras por rede

Os limites de tamanho e formato são aplicados pelo adaptador, não por você.

Mídia ordenada

A ordem no bloco de conteúdo é a ordem do carrossel.

Falhas claras

Um arquivo que uma rede não aceita falha apenas naquela entrega, com o motivo, e não no post inteiro.

Gerencie

Navegue, busque e reutilize a biblioteca

Liste a biblioteca com filtros, busque qualquer item por um endpoint de arquivo que verifica a participação no espaço de trabalho a cada solicitação e nunca expira, e use o mesmo id em quantos posts quiser. Ativos da marca, importações e imagens geradas ficam todos na mesma biblioteca.

Comece a construir
GET /v1/media
curl "https://api.fopost.com/v1/media?workspace_id=9b2f6c1e-...&type=image" \
  -H "X-API-Key: $API_KEY"

# Fetch the file itself
curl -L "https://api.fopost.com/v1/media/e5a1c9d4-.../file" \
  -H "X-API-Key: $API_KEY" -o launch.png

Listar e filtrar

Por tipo, origem ou função na marca, com paginação.

URL de arquivo estável

/v1/media/:id/file always works for members; no signed links to refresh.

Restrito ao espaço de trabalho

Uma chave vê a biblioteca de um espaço de trabalho e nada mais.

Perguntas sobre API de mídia, respondidas

Qual é o limite de tamanho?

50 MB por arquivo. Cada rede tem seus próprios limites, verificados quando um post é entregue a essa rede.

Quais formatos são aceitos?

Formatos comuns de imagem (PNG, JPEG, GIF, WebP) e vídeo (MP4, MOV). O upload verifica os bytes reais do arquivo, então um arquivo renomeado é rejeitado.

Posso anexar um id de mídia a mais de um post?

Sim. Esse é o propósito da biblioteca. Envie uma vez e use o id em qualquer post do espaço de trabalho.

Os arquivos enviados são públicos?

Não. O armazenamento é privado. O endpoint de arquivo verifica a participação no espaço de trabalho a cada solicitação, e as redes recebem um link de curta duração apenas no momento da publicação.

Isso conta para alguma cota?

Sim, todas as contas incluem uma franquia gratuita de armazenamento, e o que passar dela é medido por GB ao mês com um cartão cadastrado. Todo upload, importação e imagem gerada conta da mesma forma.

Posso importar de uma URL ou de uma ferramenta de design?

Sim, as importações entram na mesma biblioteca e trazem uma referência da origem, então você pode atualizar um design no mesmo lugar em vez de enviar um novo arquivo.

Comece a construir com API de mídia hoje

Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.

Obtenha sua chave de API