Collections

In noonjs, collections represent your structured data, and the REST API provides full CRUD operations to interact with them. The API is stateless, ensuring each request is independent and doesn't rely on any prior interactions. All limitations and access controls are configured in the config.json file. Each collection config allows you to set detailed permissions, ensuring that only authorized users can access or modify data, following the principle of least privilege.

GET /todos
            
// result: 
[
  {
    "_id": "60b8d6a9b13b8c47a7a2a7bc",
    "title": "Do laundry",
    "done": 1627848000
  },
  {
    "_id": "60b8d6a9b13b8c47a7a2a7bd",
    "title": "Write code",
    "done": 1627934400
  },
  {
    "_id": "60b8d6a9b13b8c47a7a2a7be",
    "title": "Buy groceries"
  },
  {
    "_id": "60b8d6a9b13b8c47a7a2a7bf",
    "title": "Clean the house"
  },
  {
    "_id": "60b8d6a9b13b8c47a7a2a7c0",
    "title": "Attend meeting",
    "done": 1628020800
  },
  {
    "_id": "60b8d6a9b13b8c47a7a2a7c1",
    "title": "Finish project report"
  }
]

Get – Fetch multiple records from a collection with filtering, sorting, and pagination support.

Post – Create a new record in the collection with automatic validation and permission checks.

Patch – Update an existing record with partial data, ensuring only allowed fields are modified.

Delete – Remove a record from the collection, following configured deletion rules.

Count – Retrieve the total number of records in a collection based on filters.

All these operations are fully configurable in config.json, allowing you to define access permissions and data constraints effortlessly.