init

2025-08-07 15:36:26 +09:00
commit cc925e0475
1172 changed files with 142573 additions and 0 deletions
@@ -0,0 +1,103 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "케이뱅크 OAuth 2.0 토큰 발급",
+    "description": "OAuth 2.0 토큰 발급을 위한 API 문서입니다.",
+    "version": "1.0.0"
+  },
+  "paths": {
+    "/api/v1/oauth/token": {
+      "post": {
+        "summary": "케이뱅크 액세스 토큰 발급",
+        "description": "client_credentials grant type을 사용하여 액세스 토큰을 발급받습니다.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/x-www-form-urlencoded": {
+              "schema": {
+                "type": "object",
+                "required": ["grant_type", "client_id", "client_secret", "scope"],
+                "properties": {
+                  "grant_type": {
+                    "type": "string",
+                    "enum": ["client_credentials"],
+                    "description": "권한 부여 방식 (client_credentials)"
+                  },
+                  "client_id": {
+                    "type": "string",
+                    "maxLength": 256,
+                    "description": "케이뱅크에서 발급한 client id"
+                  },
+                  "client_secret": {
+                    "type": "string",
+                    "maxLength": 512,
+                    "description": "케이뱅크에서 발급한 client secret"
+                  },
+                  "scope": {
+                    "type": "string",
+                    "maxLength": 1024,
+                    "description": "해당 업무의 Access Token 권한 범위",
+                    "default": "api"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "토큰 발급 성공",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "access_token": {
+                      "type": "string",
+                      "maxLength": 600,
+                      "description": "JWT 형식의 액세스 토큰"
+                    },
+                    "token_type": {
+                      "type": "string",
+                      "maxLength": 6,
+                      "enum": ["bearer"],
+                      "description": "토큰 타입"
+                    },
+                    "expires_in": {
+                      "type": "integer",
+                      "maxLength": 11,
+                      "description": "토큰 만료 시간(초)"
+                    },
+                    "scope": {
+                      "type": "string",
+                      "maxLength": 1024,
+                      "description": "부여된 scope"
+                    },
+                    "jti": {
+                      "type": "string",
+                      "maxLength": 256,
+                      "description": "JWT ID"
+                    }
+                  }
+                },
+                "example": {
+                  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
+                  "token_type": "bearer",
+                  "expires_in": 86399,
+                  "scope": "api",
+                  "jti": "e76ea359-81ee-4335-8703-4bb5f1937634"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "잘못된 요청"
+          },
+          "401": {
+            "description": "인증 실패"
+          }
+        }
+      }
+    }
+  }
+}