1. Artigos
Veploy API
  • Visão geral
  • Autenticação
  • Limites de requisição
  • Imóveis
    • Listar imóveis
    • Consultar imóvel
    • Cadastrar imóvel
    • Alterar imóvel
    • Excluir imóvel
    • Restaurar imóvel
    • Enviar foto do imóvel (Beta)
    • Remover foto do imóvel (Beta)
    • Listar tipos de imóvel
  • Proprietários
    • Listar proprietários
    • Consultar proprietário
    • Cadastrar proprietário
    • Alterar proprietário
    • Excluir proprietário
  • Leads
    • Listar leads
    • Consultar lead
    • Criar lead
    • Alterar responsável
    • Atualizar lead
    • Consultar linha do tempo do lead
  • Visitas
    • Listar visitas
    • Consultar visita
    • Agendar visita
    • Alterar visita
  • Propostas
    • Listar propostas
    • Consultar proposta
    • Registrar proposta
    • Alterar proposta
  • Portais
    • Listar portais
    • Consultar portal
    • Listar imóveis do XML
  • Usuários
    • Listar usuários
    • Consultar usuário
    • Consultar permissões do usuário
    • Convidar usuário
    • Alterar ficha do usuário
    • Desativar usuário
    • Reativar usuário
    • Remover usuário
  • Perfis de acesso
    • Listar perfis de acesso
  • Artigos
    • Listar artigos
      GET
    • Criar artigo
      POST
    • Consultar artigo
      GET
    • Alterar artigo
      PATCH
    • Enviar capa do artigo (Beta)
      POST
  • Temas
    • Tema do site
  1. Artigos

Enviar capa do artigo (Beta)

POST
/v1/articles/{id}/cover
Beta: o contrato pode receber ajustes.
Envia uma imagem e a define como capa do artigo em uma chamada. Corpo multipart/form-data com a parte file e, opcionalmente, alt. Equivale a POST /v1/media com purpose=article seguido de PATCH com cover_image_id: a capa anterior volta a ter prazo de uso. A imagem é validada pelo conteúdo (JPEG, PNG ou WebP), otimizada e gravada no CDN da conta.
Respostas
200: artigo com a nova capa.
400: arquivo ausente, tipo não aceito, imagem fora das dimensões ou campo inválido.
404 ARTICLE_NOT_FOUND: inexistente, de outra conta ou na lixeira.
413 FILE_TOO_LARGE: arquivo acima de 10 MB.
429 UPLOAD_CONCURRENCY_EXCEEDED: a conta já tem 6 uploads em andamento; nada foi lido. Reenvie após o Retry-After.
503: o armazenamento ou o otimizador de imagem não respondeu, ou há uploads demais em andamento na plataforma (UPLOAD_BUSY); nada foi gravado. Retry-After diz quando tentar de novo.
Não aceita Idempotency-Key: reenviar o mesmo arquivo cria outra mídia.

Requisição

Authorization
Bearer Token
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
or
Parâmetros de Caminho

Parâmetros Bodymultipart/form-dataNecessário

Respostas

🟢200
application/json
Default Response
Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🟠413
🟠429
🔴500
🔴503
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.veploy.com/v1/articles//cover' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'alt=""'
Response Response Example
200 - Exemplo 1
{
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "title": "string",
        "slug": "string",
        "status": "published",
        "excerpt": null,
        "content": "string",
        "cover_image_id": null,
        "cover_image_url": null,
        "categories": [
            {
                "slug": "string",
                "name": "string"
            }
        ],
        "tags": [
            "string"
        ],
        "author_id": "78424c75-5c41-4b25-9735-3c9f7d05c59e",
        "author": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string",
            "email": "string",
            "phone": "string",
            "cpf": "string",
            "creci": "string",
            "birth_date": "string",
            "avatar_url": "string",
            "role": "string",
            "status": "active",
            "lead_distribution_enabled": true,
            "username": "string",
            "invited_at": "2019-08-24T14:15:22.123Z",
            "email_confirmed_at": "2019-08-24T14:15:22.123Z",
            "created_at": "2019-08-24T14:15:22.123Z"
        },
        "published_at": "2019-08-24T14:15:22.123Z",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z"
    }
}
Modificado em 2026-11-12 20:13:31
Página anterior
Alterar artigo
Próxima página
Tema do site
Built with