bitforum-backend/Web.Api/postman/News API.postman_collection.json

{
	"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\": \"<p>Bitcoin has surged past the $100,000 mark for the first time...</p>\",\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}"
				}
			]
		}
	]
}