1. 程式人生 > >user-getter介面文件

user-getter介面文件

概述

系統分為賬號管理與賬號池管理,通過賬號管理介面來進行賬號的新增、刪除、獲取等操作,通過賬號池管理介面來進行初始化、出隊、入隊等操作。

賬號管理

新增賬號

POST http://10.9.11.167:8081/users

request

引數名

型別

必填/選填

name

String

必填

password

String

必填

response

成功

HTTP/1.1 201

{      "id" : 4,      "name" "testuser3"
,      "password" "test-user-password" }

查詢賬號

GET http://10.9.11.167:8081/users/{uid}

request

引數名

型別

必填/選填

uid

String

必填

response

成功

HTTP/1.1 200

{      "id" : 4,      "name" "testuser3" ,      "password" "test-user-password" }

失敗

HTTP/1.1 404

通過使用者名稱查詢賬號

GET http://10.9.11.167:8081/users/findByName/{name}

request

引數名

型別

必填/選填

name

String

必填

response

成功

HTTP/1.1 200

{      "id" : 4,      "name" "testuser3" ,      "password" "test-user-password" }

失敗

HTTP/1.1 404

刪除賬號

DELETE http://10.9.11.167:8081/users/{uid}

request

引數名

型別

必填/選填

uid

String

必填

response

成功

HTTP/1.1 200

{      "id" : 4,      "name" "testuser3" ,      "password" "test-user-password" }

失敗

HTTP/1.1 404

獲取賬號列表

GET http://10.9.11.167:8081/users

response

HTTP/1.1 200

成功

[      {          "id" : 7,          "name" "testuser5" ,          "password" "test-user-password"      },      {          "id" : 6,          "name" "testuser4" ,          "password" "test-user-password"      },      {          "id" : 5,          "name" "testuser2" ,          "password" "test-user-password"      } ]

賬號池管理

賬號池初始化

GET http://10.9.11.167:8081/userPool/init

response

HTTP/1.1 200

成功

[      {          "id" : 7,          "name" "testuser5" ,          "password" "test-user-password"      },      {          "id" : 6,          "name" "testuser4" ,          "password" "test-user-password"      },      {          "id" : 5,          "name" "testuser2" ,          "password" "test-user-password"      } ]

賬號池出隊

GET http://10.9.11.167:8081/userPool/pop

response

成功

HTTP/1.1 200

{      "id" : 4,      "name" "testuser3" ,      "password" "test-user-password" }

失敗

HTTP/1.1 404

賬號池入隊

GET http://10.9.11.167:8081/userPool/push

request

引數名

型別

必填/選填

name

String

必填

成功

HTTP/1.1 200

true

失敗

HTTP/1.1 200

false