API Reference
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âmetro | Tipo | Descrição |
|---|---|---|
collectionId | string | Filtra 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
| Campo | Tipo | Descrição |
|---|---|---|
title* | string | Título do recurso |
url* | string | URL válida |
collectionId* | string | ID da coleção de destino |
categoryIds* | string[] | IDs das categorias (mínimo 1) |
description | string | Descrição |
iconUrl | string | URL do favicon |
ogImageUrl | string | URL 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âmetro | Tipo | Descrição |
|---|---|---|
id | string | ID do recurso |
Corpo da requisição
| Campo | Tipo | Descrição |
|---|---|---|
title | string | Novo título |
description | string | null | Nova descrição |
url | string | Nova URL válida |
iconUrl | string | null | Novo favicon |
ogImageUrl | string | null | Nova imagem OG |
collectionId | string | Mover para outra coleção |
categoryIds | string[] | Substituir categorias |
Resposta 200
Retorna o objeto do recurso atualizado.
DELETE /api/resources/[id]
Remove um recurso.
Resposta 200
{ message: "Resource deleted successfully" }