API ReferenceCollections
GET /collections/items
Listar todos os itens do usuário
GET
/collections/itemsAuth: accessTokenLista todos os itens de todas as coleções do usuário autenticado, com suporte a busca textual, paginação por cursor e filtros.
Request
Query Parameters
| Param | Tipo | Descrição |
|---|---|---|
| q | string | Busca textual por nome |
| cursor | string | Cursor de paginação |
| limit | number (1–100) | Quantidade de resultados (padrão: 30) |
| sort | recent|oldest|name|name_desc|rating | Ordenação dos resultados |
| collection_id | uuid | Filtrar por coleção específica |
Response
200
{
"items": [
{
"id": "uuid",
"collectionId": "uuid",
"name": "string",
"coverUrl": "string | null",
"fields": {},
"rating": "number | null",
"comment": "string | null",
"createdAt": "ISO 8601",
"collectionName": "string",
"collectionTypeKey": "string",
"collectionTypeIcon": "string"
}
],
"nextCursor": "string | null"
}Erros
| Código | Descrição |
|---|---|
| 401 | Não autenticado |
Exemplos
curl -X GET 'https://geeksocialapi.homelab-cloud.com/collections/items' \
-H 'Authorization: Bearer SEU_ACCESS_TOKEN'await fetch('https://geeksocialapi.homelab-cloud.com/collections/items', {
method: 'GET',
headers: { Authorization: 'Bearer ' + accessToken },
})