Get Started
Get Started
本指南帮助你从 0 到 1 完成首个打印任务。
1. 服务地址
生产地址：
https://api.printbase.cloud2. 用户注册与登录（Web）
注册：
curl -X POST https://api.printbase.cloud/v1/auth/register \
-H "Content-Type: application/json" \
-d '{
"email":"admin@example.com",
"password":"Passw0rd!",
"name":"Admin",
"organization_id":"org_default"
}'登录：
curl -X POST https://api.printbase.cloud/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"admin@example.com","password":"Passw0rd!"}'将返回 token 用于 Authorization: Bearer <TOKEN>。
3. 创建服务端 API Key
curl -X POST https://api.printbase.cloud/v1/api-keys \
-H "Authorization: Bearer <USER_JWT>" \
-H "Content-Type: application/json" \
-d '{"name":"backend-service"}'4. 连接 Agent
在本地机器运行 Agent：
PRINTBASE_API_KEY=pb_live_xxx ./agent-darwin-arm64Agent 会自动注册、上报打印机并建立 WebSocket 长连接。
5. 创建首个打印任务
curl -X POST https://api.printbase.cloud/v1/print-jobs \
-H "Authorization: Bearer pb_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"printer_id":"printer_123",
"content_type":"pdf",
"content":"JVBERi0xLjQK...",
"copies":1,
"options":{"duplex":false}
}'预期返回：
{ "id": "job_xxx", "status": "queued" }