Skip to content

Latest commit

 

History

History
159 lines (144 loc) · 2.55 KB

announces.md

File metadata and controls

159 lines (144 loc) · 2.55 KB

Find Announces

GET /announces

Description

Find announces by condition

Request

Headers

Name Required Description
X-NCU-API-TOKEN yes your API token
## Query Parameters
Name Required Description
size no fetch size, 1 ~ 40, default to 20
type yes announce type
older_than no query announces older than specified id
newer_than no query announces newer than specified id

if older_than and newer_than are presented at same time, only older_than is considered

Announce Type

type description
common 一般公告
group 組務公告

Example

GET /announces?size=2&type=common   ( latest announces with common type )
GET /announces?size=2&type=group&older_than=10   ( group announces older than the announce whose id = 10 )

Response

Formats

  • json

Structure

Field Name Type Value Description
id Integer announce id
title String announce title
content String announce content
time String announce created time
attachment String announce attachement url

Example

[
	{
		"id":1,
		"title":"變形金剛-舞台車車體視覺設計競圖大賽",
		"content":"內容",
		"time":"2015-05-01 15:42",
		"attachment": "http://www.api.com/file/file1.txt"
	},
	{
		"id":2,
		"title":"2015德明盃3D超商全國經營管理",
		"content":"內容",
		"time":"2015-05-01 15:28",
		"attachment":null
	}
]
[[
	{
		"id":9,
		"title":"百年校慶創意市集攤位招募中",
		"content":"內容",
		"time":"2015-04-28 16:13",
		"attachment":null
	},
	{
		"id":6,
		"title":"103-2社團指導老師「授課費用」核定結果",
		"content":"內容",
		"time":"2015-04-09 14:19",
		"attachment":null
	}
]]