dpot-backend/Web.Api/postman/Studio.postman_collection.json

{
  "info": {
    "_postman_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Studio",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_exporter_id": "40701166"
  },
  "item": [
    {
      "name": "채널 설정",
      "item": [
        {
          "name": "채널 설정 조회",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/studio/settings",
              "host": ["{{baseUrl}}"],
              "path": ["api", "studio", "settings"]
            },
            "description": "YouTube 채널 연동 여부 및 채널 정보 조회 (channelName, handle, description, channelUrl, viewerLink, contactEmail, thumbnailUrl)"
          },
          "response": []
        }
      ]
    },
    {
      "name": "채널 연결",
      "item": [
        {
          "name": "연동 상태 조회",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/studio/channel",
              "host": ["{{baseUrl}}"],
              "path": ["api", "studio", "channel"]
            },
            "description": "YouTube 채널 연동 상태 및 채널 기본 정보 조회 (isConnected, channelName, handle, thumbnailUrl, isActive)"
          },
          "response": []
        },
        {
          "name": "YouTube OAuth URL 발급",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/studio/youtube-connect-url?redirectUri={{frontendUrl}}/api/auth/youtube/callback",
              "host": ["{{baseUrl}}"],
              "path": ["api", "studio", "youtube-connect-url"],
              "query": [
                {
                  "key": "redirectUri",
                  "value": "{{frontendUrl}}/api/auth/youtube/callback",
                  "description": "OAuth 인증 후 돌아올 콜백 URL"
                }
              ]
            },
            "description": "Google OAuth Authorization URL 반환. 프론트엔드에서 해당 URL로 리다이렉트하여 YouTube 연동 시작"
          },
          "response": []
        },
        {
          "name": "YouTube 채널 연결 (코드 교환)",
          "request": {
            "method": "POST",
            "header": [],
            "body": {
              "mode": "raw",
              "raw": "{\n    \"Code\": \"4/0Aci98E...\",\n    \"RedirectUri\": \"{{frontendUrl}}/api/auth/youtube/callback\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/api/studio/youtube-connect",
              "host": ["{{baseUrl}}"],
              "path": ["api", "studio", "youtube-connect"]
            },
            "description": "Google OAuth 인증 코드를 교환하여 MemberOAuthToken 저장 및 Channel 엔티티 생성/업데이트. 프론트엔드 콜백 Route Handler에서 자동 호출됨"
          },
          "response": []
        }
      ]
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{accessToken}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://localhost:4000"
    },
    {
      "key": "frontendUrl",
      "value": "https://localhost:3000"
    }
  ]
}