Creates a new Person.
Access control
- Permission level
3or higher is required to create a Person
Endpoints
Creating a new Person is possible via these endpoints:
| Method | Path | Authentication |
|---|---|---|
POST | /people/jwt | JSON Web Token |
POST | /people/key | API Key & Secret |
Request body
| Property | Type | Description |
|---|---|---|
img | string | An image data-uri to store with this Person |
imperial | boolean | Whether this Person prefers imperial measurements (true) or not (false) |
name | string | A name for the Person |
notes | string | User notes for the person |
measies | object | The measurements for this person |
public | string | The name of the design this Pattern is an instance of |
Response status codes
Possible status codes for these endpoints are:
| Status code | Description |
|---|---|
201 | success |
400 | the request was malformed |
401 | the request lacks authentication |
403 | authentication failed |
500 | server error |
NOTE
If the status code is not
201
the error property
in the response body should indicate the nature of the problem.Response body
| Value | Type | Description |
|---|---|---|
result | String | Either success or error |
error | String | Will give info on the nature of the error. Only set if an error occurred. |
person.id | Number | The ID of the Person |
person.createdAt | String | Date string indicating the moment the Person was created |
person.img | String | The URL to the image stored with this Person |
person.name | String | The name of the Person |
person.notes | String | The notes stored with the Person |
person.userId | Number | The ID of the user who created the Person |
person.measies | Object | The measurements of the Person |
person.public | Boolean | Indicates whether the Person is publicly accessible or not |
person.updatedAt | String | Date string indicating the last time the Person was updated |
Example request
Javascript
const person = await axios.post(
'https://backend.freesewing.org/people/jwt',
{
name: "Someone",
notes: "These are some notes",
measies: {
"chest": 930,
"neck": 360
},
public: true,
imperial: false,
img: "data:image/png;base64,iVBORw0KGgoAAAANSUhEU...truncated"
},
{
headers: {
Authorization: `Bearer ${token}`
}
}
)
Example response
JSON
201
{
"result": "success",
"person": {
"id": 27,
"createdAt": "2022-11-19T17:36:41.342Z",
"img": "https://cdn.sanity.io/images/hl5bw8cj/production/a1565c8c6c70cfe7ea0fdf5c65501cd885adbe78-200x187.png",
"imperial": false,
"name": "Someone",
"notes": "These are some notes",
"userId": 12,
"measies": {
"chest": 930,
"neck": 360
},
"public": true,
"updatedAt": "2022-11-19T17:36:41.342Z"
}
}