## 6\. Consumers *地址*：/consumers *說明*：Consumer 是某類服務的消費者，需與用戶認證體系配合才能使用。 ### 6.1 請求方法 | 序號 | NAME | 請求URI | 請求body | 說明 | | --- | --- | --- | --- | --- | | 1 | POST | /consumers | {...} | 新增consumers | | 2 | GET | /consumers | | 查詢consumers列表 | | 3 | GET | /consumers/{username or id} | | 獲取consumers信息 | | 4 | GET | /plugins/{plugin id}/consumer | | 同上 | | 5 | PATCH | /consumers/{username or id} | {...} | 更新consumers信息 | | 6 | PATCH | /plugins/{plugin id}/consumer | {...} | 同上 | | 7 | PUT | /consumers/{username or id} | {...} | 新增/更新consumers | | 8 | PUT | /plugins/{plugin id}/consumer | {...} | 同上 | | 9 | DELETE | /consumers/{username or id} | | 刪除consumers | ### 6.2 body 請求參數 | 序號 | 參數名 | 可選 | 默認值 | 說明 | 示例 | | --- | --- | --- | --- | --- | --- | | 1 | username | 半選 | | 用戶名，必須唯一，username和custom\_id兩者必須填寫一項 | zhangshan | | 2 | custom\_id | 半選 | | 唯一標識，必須保證唯一,username和custom\_id兩者必須填寫一項 | | | 3 | tags | 可選 | | | | ### 6.3 數據樣例 body 請求參數 ``` { "id": "ec1a1f6f-2aa4-4e58-93ff-b56368f19b27", "created_at": 1422386534, "username": "my-username", "custom_id": "my-custom-id", "tags": ["user-level", "low-priority"] } ``` consumers列表 ``` { "data": [{ "id": "a4407883-c166-43fd-80ca-3ca035b0cdb7", "created_at": 1422386534, "username": "my-username", "custom_id": "my-custom-id", "tags": ["user-level", "low-priority"] }, { "id": "01c23299-839c-49a5-a6d5-8864c09184af", "created_at": 1422386534, "username": "my-username", "custom_id": "my-custom-id", "tags": ["admin", "high-priority", "critical"] }], "next": "http://localhost:8001/consumers?offset=6378122c-a0a1-438d-a5c6-efabae9fb969" } ```