Improve API to return id instead of a boolean

This commit is contained in:
Frédéric Guillot
2014-11-22 18:22:10 -05:00
parent 15038cdb10
commit 77e10d2582
13 changed files with 270 additions and 310 deletions

View File

@@ -149,7 +149,7 @@ Procedures
- Purpose: **Create a new project**
- Parameters:
- **name** (string, required)
- Result on success: **true**
- Result on success: **project_id**
- Result on failure: **false**
Request example:
@@ -171,7 +171,7 @@ Response example:
{
"jsonrpc": "2.0",
"id": 1797076613,
"result": true
"result": 2
}
```
@@ -487,10 +487,9 @@ Response example:
}
```
### getAllowedUsers
### getMembers
- Purpose: **Get allowed users for a given project**
- Note: Only people explicitly allowed are part of this list, administrators are always authorized
- Purpose: **Get members of a project**
- Parameters:
- **project_id** (integer, required)
- Result on success: Key/value pair of user_id and username
@@ -943,7 +942,7 @@ Response example:
- **score** (integer, optional)
- **date_due**: ISO8601 format (string, optional)
- **category_id** (integer, optional)
- Result on success: **true**
- Result on success: **task_id**
- Result on failure: **false**
Request example:
@@ -974,7 +973,7 @@ Response example:
{
"jsonrpc": "2.0",
"id": 1176509098,
"result": true
"result": 3
}
```
@@ -1279,7 +1278,7 @@ Response example:
- **email** (string, optional)
- **is_admin** Set the value 1 for admins or 0 for regular users (integer, optional)
- **default_project_id** (integer, optional)
- Result on success: **true**
- Result on success: **user_id**
- Result on failure: **false**
Request example:
@@ -1302,7 +1301,7 @@ Response example:
{
"jsonrpc": "2.0",
"id": 1518863034,
"result": true
"result": 22
}
```
@@ -1466,7 +1465,7 @@ Response example:
- Parameters:
- **project_id** (integer, required)
- **name** (string, required, must be unique for the given project)
- Result on success: **true**
- Result on success: **category_id**
- Result on failure: **false**
Request example:
@@ -1489,7 +1488,7 @@ Response example:
{
"jsonrpc": "2.0",
"id": 541909890,
"result": true
"result": 4
}
```
@@ -1638,7 +1637,7 @@ Response example:
- **task_id** (integer, required)
- **user_id** (integer, required)
- **content** Markdown content (string, required)
- Result on success: **true**
- Result on success: **comment_id**
- Result on failure: **false**
Request example:
@@ -1662,7 +1661,7 @@ Response example:
{
"jsonrpc": "2.0",
"id": 1580417921,
"result": true
"result": 11
}
```
@@ -1822,7 +1821,7 @@ Response example:
- **time_estimated** (int, optional)
- **time_spent** (int, optional)
- **status** (int, optional)
- Result on success: **true**
- Result on success: **subtask_id**
- Result on failure: **false**
Request example:
@@ -1845,7 +1844,7 @@ Response example:
{
"jsonrpc": "2.0",
"id": 2041554661,
"result": true
"result": 45
}
```