01 피드 — 올라가 있는 글 목록
1.1 설명
GET/feed
이 호출은 플랫폼을 부르지 않고 받아 둔 것만 줍니다. 그래서 빠르고, 플랫폼의 할당량을 쓰지 않습니다. 새로 받는 일은 POST /feed 가 맡습니다.
1.2 파라미터
| 이름 | 구분 | 설명 |
|---|---|---|
workspace | 필수 | 워크스페이스 코드 |
limit | 선택 | 가져올 줄 수(1~50). 기본 20. 범위를 벗어난 값은 무시하고 기본값을 씁니다 |
cursor | 선택 | 이어 읽기. 이전 응답의 next 를 그대로 넣습니다. 우리 내부 형식이므로 뜻을 해석하지 마십시오 |
1.3 요청
curl "https://moacast.com/api/moacast/v1/feed?workspace=a1b2c3d4&limit=20" \
-H 'Authorization: Bearer <ACCESS_TOKEN>'1.4 성공 응답
{
"result": "SUCCESS",
"result_code": 0,
"data": {
"workspace": "a1b2c3d4",
"items": [
{
"channel": "youtube",
"id": "dQw4w9WgXcQ",
"text": "새 영상을 올렸습니다",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"thumb": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg",
"type": "video",
"when": 1790420673,
"origin": "",
"stats": {
"likes": 12,
"comments": 3,
"views": 840
}
}
],
"next": "",
"fetched_at": 1790420673,
"stale": false
}
}1.5 필드
| 필드 | 타입 | 설명 |
|---|---|---|
workspace | string | 워크스페이스 코드 |
items | array | 글 목록. 최근 것부터. 한 줄의 모양은 아래와 같습니다 |
next | string | 이어 읽을 문자열. 더 없으면 빈 문자열입니다 |
fetched_at | int | 언제 기준인지(Unix 초). 받은 적 없으면 0 |
stale | bool | 받아 둔 지 오래됐는가 |
items 의 한 줄
| 필드 | 타입 | 설명 |
|---|---|---|
channel | string | 그 글이 올라간 채널 키 |
id | string | 플랫폼이 부여한 글 식별자 |
text | string | 본문 |
url | string | 그 글의 공개 주소 |
thumb | string | 대표 이미지 주소 |
type | string | text · image · video · album |
when | int | 올라간 시각(Unix 초). 표시 형식은 화면이 정합니다 |
origin | string | 아직 언제나 빈 문자열입니다. 우리로 발행한 글을 가려낼 근거가 생기면 채워집니다 |
stats | object | 좋아요·댓글·조회 수입니다. 플랫폼이 주지 않는 값은 0 이 아니라 null 입니다 |
1.6 실패
| 코드 | HTTP | 언제 |
|---|---|---|
9912 | 400 | workspace 를 주지 않았습니다 |
1001 | 401 | 헤더가 없거나 토큰이 올바르지 않습니다 |
2000 | 404 | 그 워크스페이스가 없거나, 이 토큰으로 다룰 수 없습니다 |