Imagens

Visão Geral

O módulo Imagens permite o envio de imagens vinculadas a diferentes entidades do sistema, como empresas, produtos e pessoas. O tipo da entidade é informado no caminho da requisição, tornando o endpoint genérico e reutilizável para qualquer módulo que suporte imagens.

Base URL

/api/imagens
Todos os endpoints requerem autenticação via Bearer Token:
Authorization: Bearer {token}

Endpoints

POST /api/imagens/{tipo}/{id}

Descrição: Faz o upload de uma imagem vinculada a uma entidade específica do sistema. O campo tipo identifica a qual módulo a imagem pertence (ex: empresa, produto, pessoa), e id é o identificador do registro.

Parâmetros

NomeTipoLocalObrigatórioDescrição
tipostringpath✓Tipo da entidade. Valores aceitos: empresa, produto, pessoa
idinteger (int64)path✓ID do registro ao qual a imagem será vinculada

Corpo da Requisição

Envio via multipart/form-data:

CampoTipoDescrição
filebinárioArquivo de imagem a ser enviado (JPG, PNG, WEBP)

Exemplo com cURL:

curl -X POST "https://api.app.hooked.com.br/api/imagens/produto/10" \
  -H "Authorization: Bearer {token}" \
  -F "file=@foto_produto.jpg"

Resposta de Sucesso 200

"Success"

Códigos de Erro

CódigoDescrição
400Nenhum arquivo enviado ou formato não suportado
401Token ausente ou inválido
404Entidade não encontrada para o tipo e ID informados
500Erro interno do servidor

Exemplos de Código

cURL

curl -X POST "https://api.app.hooked.com.br/api/imagens/{tipo}/{id}" \
  -H "Authorization: Bearer {token}" \
  -F "[email protected]"

JavaScript

const form = new FormData();
form.append('files', arquivo, 'arquivo.pdf');

const response = await fetch('https://api.app.hooked.com.br/api/imagens/{tipo}/{id}', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer {token}' },
  body: form
});
const data = await response.json();

Python

import requests

with open('arquivo.pdf', 'rb') as f:
    data = requests.post(
        'https://api.app.hooked.com.br/api/imagens/{tipo}/{id}',
    headers={'Authorization': 'Bearer {token}'},
        files=[('files', f)]
    ).json()

Go

import (
    "bytes"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
arquivo, _ := os.Open("arquivo.pdf")
part, _ := writer.CreateFormFile("files", "arquivo.pdf")
io.Copy(part, arquivo)
writer.Close()

req, _ := http.NewRequest("POST", "https://api.app.hooked.com.br/api/imagens/{tipo}/{id}", body)
req.Header.Set("Authorization", "Bearer {token}")
req.Header.Set("Content-Type", writer.FormDataContentType())
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/imagens/{tipo}/{id}');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}'],
    CURLOPT_POSTFIELDS     => ['files' => new CURLFile('arquivo.pdf')],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — POST /api/imagens/{tipo}/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.app.hooked.com.br/api/imagens/{tipo}/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}
← ArquivosEtiquetas →