postlineDocs
GuiasReferência da APIMCPChangelogAbrir o app

Enviar uma imagem

POST
/api/v1/images

Adiciona um JPG, PNG ou WebP (até 20 MB) à Mídia do projeto, de base64, de uma url https pública ou de um file multipart. Devolve o Markdown que a coloca num artigo.

Permissão: images:write.

Autorização

apiToken
headerAutorizaçãoBearer <token>

Token de API (pl_live_…) de Organização › Chaves de API, com suas permissões e limite de 60 chamadas por minuto. Um token de projeto trabalha no seu projeto; um token de todos os projetos indica um com projectId.

Corpo da requisição

application/json
  1. body
projectId?string

O projeto, de Listar projetos. Um token de projeto preenche sozinho.

Tamanho1 <= length <= 64
base64?string
Tamanholength <= 28000000
url?string
Formatouri
Tamanholength <= 2000
fileName?string
Tamanholength <= 200
alt?string

Descreva a imagem para quem lê.

Tamanholength <= 300
license?string

own: da pessoa; licensed: precisa de crédito; public: domínio público.

Padrão"own"
Valor em"own""licensed""public"
credit?string
Tamanholength <= 200

Corpo da resposta

Criado

application/json
  1. response
Exemplo de requisição
curl -X POST 'https://app.postline.com.br/api/v1/images' \  -H 'Authorization: Bearer pl_live_…' \  -H 'Content-Type: application/json' \  -d '{  "url": "https://acme.com/images/retention.png",  "alt": "Retention chart"}'
Exemplo de resposta
{  "id": "a41d7c9e-2b58-4f03-8e6a-5c1f9d2b7e30",  "width": 1600,  "height": 900,  "markdown": "![Retention chart](image:a41d7c9e-2b58-4f03-8e6a-5c1f9d2b7e30)"}