socialforge/README.md

75 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# API文档
---
## 基本介绍
trustie平台同步其他平台数据的相关接口如Educode、Openl在获得许可权限后如下接口可在其他任何平台调用。
#### token认证
token在trustie控制台下通过Setting.api_token获取获取后可放环境变量中或者某个配置文件中
#### 同步用户数量、开源项目数量、实训项目数量
```
PUT homes/sync_count
```
*示例*
```
curl -X PUT http://localhost:3001/api/v1/homes/sync_count \
-d "token=34c82f51e0b699d9d16d70fd6497c9b1e4821d6ea3e872558a6537a091076b8e" \
-d "type=project" | jq
```
请求参数说明:
token(requires): String权限验证
type(requires): String同步的类型取值范围: {user(用户) | project(开源项目) | practical_training_project(实训项目) | school(应用高校)}
number(optional): Integer同步数量, 该参数可选不传时后台默认值为1
返回值
```
{
"status": 1,
"message": "token is invalid!"
}
```
---
#### 同步动态新闻
```
PUT homes/sync_news
```
*示例*
```
curl -X PUT http://localhost:3001/api/v1/homes/sync_news \
-d "token=34c82f51e0b699d9d16d70fd6497c9b1e4821d6ea3e872558a6537a091076b8e" \
-d "title=“基于OpenI海参的视频编码大赛”海口启动" \
-d "simple_intruduce=2019年8月31日下午“AVS工作组第70次会议暨AI标准工作组第8次会议”闭幕式在海口召开会上启动了“基于OpenI海参的视频编码大赛”哈尔滨工业大学范晓鹏教授介绍了大赛背景、选题及参赛流程等信息正式开启大赛参赛团队招募。" \
-d "remote_url=https://www.openi.org.cn/html/2019/dongtai_0903/255.html" | jq
```
请求参数说明:
cover_remote_url(optional): String, 封面访问地址
category_id(optional): Integer, 分类ID
content(optional): String, 新闻内容
title(requires): String, 新闻标题
simple_intruduce(requires): String, 新闻简介
remote_url(requires): String, 新闻访问地址
platform(requires): String, 该条数据的来源{educoder | trusite | ihub | gcc | openi |toschina | military | jiaotong_university}; 如educoder说明是来源educoder平台
返回值
```
{
"status": 1,
"message": "token is invalid!"
}
```
---