55 lines
1.2 KiB
Markdown
55 lines
1.2 KiB
Markdown
|
# API + MCP Layer
|
||
|
|
|
||
|
|
## Environment
|
||
|
|
Add to `.env.local`:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
NEXT_PUBLIC_POCKETBASE_URL=http://127.0.0.1:8090
|
||
|
|
PB_ADMIN_EMAIL=your_admin_email
|
||
|
|
PB_ADMIN_PASSWORD=your_admin_password
|
||
|
|
AGENT_API_KEY=replace_with_secure_token
|
||
|
|
ORDER_ITEMS_COLLECTION=order_items
|
||
|
|
```
|
||
|
|
|
||
|
|
## REST Endpoints
|
||
|
|
- `GET /api/v1/health`
|
||
|
|
- `GET /api/v1/orders?page=1&perPage=50&status=new`
|
||
|
|
- `POST /api/v1/orders/from-quote`
|
||
|
|
- `GET /api/v1/collection-pool?page=1&perPage=50&status=queued`
|
||
|
|
- `PATCH /api/v1/order-items/{id}/status`
|
||
|
|
|
||
|
|
Auth for agent routes:
|
||
|
|
- Header: `Authorization: Bearer <AGENT_API_KEY>`
|
||
|
|
|
||
|
|
`POST /orders/from-quote` body:
|
||
|
|
```json
|
||
|
|
{ "quote_id": "QUOTE_RECORD_ID" }
|
||
|
|
```
|
||
|
|
|
||
|
|
`PATCH /order-items/{id}/status` body supports:
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"item_status": "processed",
|
||
|
|
"drv_status": "assigned",
|
||
|
|
"notes": "Assigned to route 2"
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## MCP Endpoint
|
||
|
|
- `POST /api/mcp`
|
||
|
|
|
||
|
|
Supported methods:
|
||
|
|
- `tools/list`
|
||
|
|
- `tools/call`
|
||
|
|
|
||
|
|
Available tools:
|
||
|
|
- `orders.list`
|
||
|
|
- `orders.create_from_quote`
|
||
|
|
- `collection_pool.list`
|
||
|
|
- `order_items.update_status`
|
||
|
|
|
||
|
|
## Notes
|
||
|
|
- `ORDER_ITEMS_COLLECTION` controls where order-item writes/updates go.
|
||
|
|
- Set `ORDER_ITEMS_COLLECTION=order_items` once new collection is created/imported.
|
||
|
|
- Status endpoint accepts `driver_status` input and normalizes to `drv_status`.
|