跳到内容
兽展日历·文档
Esc
↑↓导航↵打开⌘J预览

查询活动列表

GET/open/event
Authorization
AuthorizationBearer token · headerrequired

应用访问令牌，需要 read 权限；用户登录令牌不能用于这些接口。

Query parameters
eventStartAtstring<date-time>

活动开始时间下限，UTC 时间

matches ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$
eventEndAtstring<date-time>

活动结束时间上限，UTC 时间

matches ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$
searchstring

活动名称关键词

orgSearchstring

组织名称关键词

currentnumber
default: 1
pageSizenumber
default: 20
Responses
200

分页活动列表；查询失败时可能返回空列表与 info

totalnumberrequired
currentnumberrequired
pageSizenumberrequired
dataOpenEventDto[]required
Show properties
Array of OpenEventDto
idstring<uuid>required
namestringrequired
scalestringrequired
Allowed:cosysmallmediumlargexlargexxlargemega
statusstringrequired
Allowed:cancelledmovedOnlinepostponedrescheduledscheduled
slugstringrequired
urlKeystringrequired
eventKeystringrequired
startDatestring<date-time> | nullrequired
endDatestring<date-time> | nullrequired
addressstring | nullrequired
regionstring | nullrequired
thumbnailstring | nullrequired
detailstring | nullrequired
urlstring | nullrequired
placeOpenEventPlaceDto | objectrequired
Show properties
Any of:
OpenEventPlaceDto
idstring<uuid>required
namestringrequired
kindstringrequired
addressstring | nullrequired
object
object
organizationOpenEventOrganizationDto | objectrequired
Show properties
Any of:
OpenEventOrganizationDto
namestring | nullrequired
slugstring | nullrequired
logoUrlstring | nullrequired
urlstring | nullrequired
object
object
infostring

列表查询失败时可能返回 No event available 和空数据

401

应用令牌缺失或无效

messagestringrequired
codestringrequired
paramsobject
403

应用没有 read 权限或没有接口访问权限

messagestringrequired
codestringrequired
paramsobject
422

参数校验失败

messagestringrequired
codestringrequired
errorsValidationIssueDto[]required
Show properties
Array of ValidationIssueDto
fieldstringrequired
rulestringrequired
messagestringrequired
metaobject
429

请求频率超限；Retry-After 响应头给出等待秒数

messagestringrequired
codestringrequired
paramsobject
500

服务器错误

messagestringrequired
codestringrequired
paramsobject
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.furrycons.cn/open/event' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "total": 0,
  "current": 0,
  "pageSize": 0,
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "scale": "cosy",
      "status": "cancelled",
      "slug": "string",
      "urlKey": "string",
      "eventKey": "string",
      "startDate": "2019-08-24T14:15:22Z",
      "endDate": "2019-08-24T14:15:22Z",
      "address": "string",
      "region": "string",
      "thumbnail": "string",
      "detail": "string",
      "url": "string",
      "place": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "kind": "string",
        "address": "string"
      },
      "organization": {
        "name": "string",
        "slug": "string",
        "logoUrl": "string",
        "url": "string"
      }
    }
  ],
  "info": "string"
}