Contrato da API da Home Gallery

Endpoint principal

• Metodo: GET
• Rota: /caroulsel/data
• Responsavel: ImageController::getCarouselImages

Exemplo de resposta

{
  "title": "Ultimas 10 fotos",
  "imgStyle": "height: 500px;",
  "homeGalleryLimit": 10,
  "itens": [
    {
      "id": 1,
      "text": "2026-04-17 08:30 OS:12345",
      "onclick": "nfsui.newWindow({'url':'/g/OS/dados/987'})",
      "table": "APONTAMENTO_FOTO",
      "seqDb": 123,
      "hasImage": true,
      "previewUrl": "/caroulsel/media/abc123/thumb",
      "fullUrl": "/caroulsel/media/abc123/full"
    }
  ]
}

Observacoes importantes

• homeGalleryLimit representa o limite considerado no backend;
• itens.length pode ser menor que o limite configurado (depende de dados elegiveis);
• title pode ser textual/configuracional e nao necessariamente igual ao total real;
• no frontend atual da grid, imgStyle nao governa altura dos cards (altura vem do CSS do componente).

Endpoints de midia

Thumb

• Metodo: GET
• Rota: /caroulsel/media/{token}/thumb
• Retorno: binario da imagem (Content-Type baseado no mime)

Full

• Metodo: GET
• Rota: /caroulsel/media/{token}/full
• Retorno: binario da imagem original

Regras de token/cache

• token e gerado por item e gravado em cache de sessao;
• thumb pode ser gerada e reaproveitada (setThumb);
• fallback defensivo por token evita falhas por mismatch de contexto.