/Recursos

API Reference

Recursos

Recursos são links externos (URLs) salvos dentro de coleções, com metadados como título, descrição e imagens OG. Cada recurso pode ter múltiplas categorias.

GET /api/resources

Retorna os recursos do workspace. Pode ser filtrado por coleção.

Query params

ParâmetroTipoDescrição
collectionIdstringFiltra recursos de uma coleção específica

Resposta 200

{
  id: string;
  title: string;
  url: string;
  description: string | null;
  iconUrl: string | null;
  ogImageUrl: string | null;
  collectionId: string;
  categories: { id: string; name: string; slug: string }[];
  fetchedAt: string;
}[]

POST /api/resources

Cria um novo recurso.

Corpo da requisição

CampoTipoDescrição
title*stringTítulo do recurso
url*stringURL válida
collectionId*stringID da coleção de destino
categoryIds*string[]IDs das categorias (mínimo 1)
descriptionstringDescrição
iconUrlstringURL do favicon
ogImageUrlstringURL da imagem Open Graph

Resposta 201

{
  message: "Resource created successfully";
  resource: {
    id: string;
    title: string;
    url: string;
    collectionId: string;
    categories: { id: string; name: string; slug: string }[];
    /* demais campos */
  };
}

PATCH /api/resources/[id]

Atualiza um recurso existente.

Parâmetros de rota

ParâmetroTipoDescrição
idstringID do recurso

Corpo da requisição

CampoTipoDescrição
titlestringNovo título
descriptionstring | nullNova descrição
urlstringNova URL válida
iconUrlstring | nullNovo favicon
ogImageUrlstring | nullNova imagem OG
collectionIdstringMover para outra coleção
categoryIdsstring[]Substituir categorias

Resposta 200

Retorna o objeto do recurso atualizado.

DELETE /api/resources/[id]

Remove um recurso.

Resposta 200

{ message: "Resource deleted successfully" }