当前登录用户创建一个专长
Request
HTTP request
POST https://www.featapi.com/api/user/expertise/
Parameters
无需添加参数。
Authorization
该请求需要授权以下scopes访问权限:
| Scopes |
|---|
| user_expertise |
For more information, see the authentication and authorization page.
Request body
In the request body, supply a User.expertise resource with the following properties:
| Property name | Value | Description | Notes |
| 必填 | |||
| name | string | 专长名称 | 专长名称不可以和用户已创建的专长重复 |
| applications | list | 应用场景列表，表示该专长的适用情形。列表的元素为字符类型。最多保存5个应用场景。 | 范例：[“程序”, “开发”, “python”] |
| profession_categories | list | 职业列表，表示该专长对应的岗位。列表的元素为字符类型。最多保存5个职业。 | 范例：[“python程序员”, “网站开发工程师”] |
| currency | string | 专长的收款货币 | 默认： CNY |
| is_primary | boolean | 指定该专长是否为主要专长。在展示用户基本信息的专长字段的，只显示主专长的名字。 | |
| publish | boolean | 确定是否发布 | 默认：true |
| 选填 | |||
| services | list | 设置专长的提供服务方式。最多提供三种类型服务，分别为在线服务、上门服务和工作室。 | 特定JSON 数据，结构详情查看下文 |
“services” 字段的JSON格式
| Property name | Value | Description | Notes |
| type | integer | 服务类型，100为线上服务，200为上门服务，300为工作室。 | Expertise.ServiceType |
| price | float | 价格 | |
| unit | integer | 收费单位，100为按小时收费，200为按单收费。 | Expertise.ServiceUnit |
| is_available | boolean | 服务是否可用 |
{
"services": [
{ "type": 100, "price": 50, "unit": 100, "is_available": true },
{ "type": 200, "price": 50, "unit": 100, "is_available": true },
{ "type": 300, "price": 50, "unit": 100, "is_available": true }]
}使用services字段设置服务方式的注意事项
- Services 字段是一个最多包含3个字典元素的列表，每个元素都必须有”type”、price”、 “unit”、”is_available”字段。
- “type”分为3个类型，详情查看上文的 Expertise.ServiceType。每个元素的type值不可重复。
Response
如果请求成功，该API返回创建的User.Expertise专长数据在响应体信息中。
201 Create an expertise successfully
{
"data": {
"id": 122,
"user": 7815769374283,
"username": "WenWei Yang",
"name": "Python Programming",
"applications": [ { "label": "程序" }, { "label": "开发" }, { "label": "python" } ],
"currency": "CNY",
"profession_categories": [ { "label": "python程序员" }, { "label": "网站开发工程师" } ],
"is_primary": true,
"create_time": "2019-07-09T09:10:30.225000Z",
"available_services": [ { "type": 100, "price": "300.00", "unit": 100, "is_available": true } ],
"status": 100
}}400 Validation Exception
示例返回数据可参考 API Common – Validation Exception