{ "info": { "name": "bitForum - News API", "description": "bitForum 뉴스 API 컬렉션\n\nBase URL: https://api.bitforum.io", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "baseUrl", "value": "https://localhost:4000", "type": "string" } ], "item": [ { "name": "기사 목록 조회", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/news/articles?page=1&perPage=20", "host": ["{{baseUrl}}"], "path": ["api", "news", "articles"], "query": [ { "key": "page", "value": "1", "description": "페이지 번호 (기본값: 1)" }, { "key": "perPage", "value": "20", "description": "페이지당 건수 (기본값: 20)" }, { "key": "rssFeedSourceID", "value": "", "description": "RSS 소스 ID 필터 (선택)", "disabled": true }, { "key": "keyword", "value": "", "description": "제목/내용 검색어 (선택)", "disabled": true } ] }, "description": "수집된 뉴스 기사 목록을 페이징하여 조회합니다.\n\n선택적으로 RSS 소스 ID나 키워드로 필터링할 수 있습니다." }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"status\": 200,\n \"message\": null,\n \"data\": {\n \"total\": 42,\n \"list\": [\n {\n \"id\": 1,\n \"rssFeedSourceID\": 1,\n \"feedSourceName\": \"CoinDesk RSS\",\n \"title\": \"Bitcoin Surges Past $100K\",\n \"link\": \"https://example.com/article/1\",\n \"author\": \"John Doe\",\n \"description\": \"Bitcoin has surged past the $100,000 mark...\",\n \"imageUrl\": \"https://example.com/images/btc.jpg\",\n \"sourceName\": \"CoinDesk\",\n \"categories\": \"Bitcoin,Markets\",\n \"commentCount\": 5,\n \"publishedAt\": \"2026-03-14T09:00:00Z\",\n \"createdAt\": \"2026-03-14T09:05:00Z\"\n }\n ]\n },\n \"errors\": null\n}" } ] }, { "name": "기사 상세 조회", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/news/articles/1", "host": ["{{baseUrl}}"], "path": ["api", "news", "articles", "1"] }, "description": "특정 뉴스 기사의 상세 정보를 조회합니다.\n\n목록 조회 대비 guid, content 필드가 추가로 포함됩니다." }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"status\": 200,\n \"message\": null,\n \"data\": {\n \"id\": 1,\n \"rssFeedSourceID\": 1,\n \"feedSourceName\": \"CoinDesk RSS\",\n \"title\": \"Bitcoin Surges Past $100K\",\n \"link\": \"https://example.com/article/1\",\n \"guid\": \"https://example.com/article/1\",\n \"author\": \"John Doe\",\n \"description\": \"Bitcoin has surged past the $100,000 mark...\",\n \"content\": \"
Bitcoin has surged past the $100,000 mark for the first time...
\",\n \"imageUrl\": \"https://example.com/images/btc.jpg\",\n \"sourceName\": \"CoinDesk\",\n \"categories\": \"Bitcoin,Markets\",\n \"commentCount\": 5,\n \"publishedAt\": \"2026-03-14T09:00:00Z\",\n \"createdAt\": \"2026-03-14T09:05:00Z\"\n },\n \"errors\": null\n}" }, { "name": "404 Not Found", "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"status\": 404,\n \"message\": \"뉴스 기사를 찾을 수 없습니다.\",\n \"data\": null,\n \"errors\": null\n}" } ] }, { "name": "RSS 소스 목록 조회", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/news/sources", "host": ["{{baseUrl}}"], "path": ["api", "news", "sources"] }, "description": "활성화된 RSS 피드 소스 목록을 조회합니다." }, "response": [ { "name": "200 OK", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"status\": 200,\n \"message\": null,\n \"data\": {\n \"sources\": [\n {\n \"id\": 1,\n \"name\": \"CoinDesk RSS\",\n \"url\": \"https://www.coindesk.com/arc/outboundfeeds/rss/\",\n \"description\": \"CoinDesk 암호화폐 뉴스\",\n \"isActive\": true,\n \"lastFetchedAt\": \"2026-03-14T09:00:00Z\"\n },\n {\n \"id\": 2,\n \"name\": \"CoinTelegraph RSS\",\n \"url\": \"https://cointelegraph.com/rss\",\n \"description\": \"CoinTelegraph 뉴스 피드\",\n \"isActive\": true,\n \"lastFetchedAt\": \"2026-03-14T08:45:00Z\"\n }\n ]\n },\n \"errors\": null\n}" } ] } ] }