Developer API Documentation

Integration API for managing E-ink Todo List items.

Base URL

https://www.einktodo.com

Request Headers

Header	Required	Description
`x-api-key`	Yes	Your API Key. Get it here.
`Content-Type`	Yes	Must be `application/json` for POST/PATCH requests.

Endpoints

1. List Todos

GET /api/developer/todo

Returns a list of todo items.

Parameters:

page (optional): Page number (default: 1)
limit (optional): Items per page (default: 10, max 100)
completed (optional): Filter by completion status (true or false)

Response:

{
  "data": [
    {
      "id": "...",
      "title": "Buy Milk",
      "completed": false
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 10,
    "totalPages": 1
  }
}

2. Create Todo

POST /api/developer/todo

Create a new todo item.

Body:

{
  "title": "Buy Milk",
  "remark": "2L, Whole milk",
  "tags": ["groceries"]
}

3. Batch Create/Upsert

POST /api/developer/todo/batch

Batch create or update multiple todos.

Body:

{
  "list": [
    { "title": "Task 1" },
    { "id": "existing-id", "title": "Updated Task" }
  ]
}