​

Collections & Documents

​

Collections API

​

Create Collection

• Endpoint: POST /collections
• Body: { "name": "posts" }

​

List Collections

• Endpoint: GET /collections

​

Get Collection

• Endpoint: GET /collections/{collection}

​

Update Collection

• Endpoint: PATCH /collections/{collection}

​

Delete Collection

• Endpoint: DELETE /collections/{collection}

​

Documents API

​

Create Document

• Endpoint: POST /collections/{collection}
• Example:

curl -X POST https://api.cocobase.cc/collections/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My New Post",
    "content": "Hello World!"
  }'

​

Get Document

• Endpoint: GET /collections/{collection}/{id}

​

List Documents

• Endpoint: GET /collections/{collection}
• Query Params:
  • limit: Max items (default: 20, max: 100)
  • offset: Skip items
  • orderBy: Field to sort by
  • order: asc or desc

​

Filtering

• field=value (Equal)
• field__gt=value (Greater Than)
• field__contains=value (String search)
• field__in=v1,v2 (Array match)

​

Update Document

• Endpoint: PATCH /collections/{collection}/{id} (Partial update)
• Endpoint: PUT /collections/{collection}/{id} (Full replacement)

​

Delete Document

• Endpoint: DELETE /collections/{collection}/{id}

​

Batch Operations

​

Batch Create

{
  "documents": [
    { "title": "Post 1" },
    { "title": "Post 2" }
  ]
}

​

Batch Delete

{
  "ids": ["doc_123", "doc_456"]
}

​

Examples

// Create
const res = await fetch('https://api.cocobase.cc/collections/posts', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_KEY' },
  body: JSON.stringify({ title: 'New Post' })
});

// List with Filter
const users = await fetch('https://api.cocobase.cc/collections/users?role=admin');

curl https://api.cocobase.cc/collections/posts?limit=10 \
  -H "Authorization: Bearer YOUR_API_KEY"