WinCL

WinCL Auth API

Auth Controller

GitHub OpenAPI

Operations 7

POST /api/v1/auth/check/email 이메일 중복확인 #
POST /api/v1/auth/check/loginid 로그인 아이디 중복확인 #
POST /api/v1/auth/check/nickname 닉네임 중복확인 #
POST /api/v1/auth/jwt/create 토큰 발급 #
GET /api/v1/auth/payco/accessToken 페이코 AccessToken 발급 #
POST /api/v1/auth/signin OAuth 로그인 #
POST /api/v1/auth/signup 회원가입 #

Documentation

📖
APIReference
https://api.wincl.io/v3/api-docs
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/authentication/wincl-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/openapi/wincl-auth-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/conventions/wincl-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/errors/wincl-error-codes.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/lifecycle/wincl-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/conformance/wincl-conformance.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/data-model/wincl-data-model.yml
🔗
AgenticAccess
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/agentic-access/wincl-agentic-access.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/wincl-auth-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

wincl-auth-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Wincl Admin Auth API
  version: '1.0'
  description: Admin Controller
servers:
- url: https://api.wincl.io:443
  description: Inferred Url
tags:
- name: Auth
  description: Auth Controller
paths:
  /api/v1/auth/check/email:
    post:
      tags:
      - Auth
      summary: 이메일 중복확인
      operationId: checkEmailUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckEmailRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_CheckEmailResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '940':
          description: INVALID_SOCIAL_EMAIL
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/auth/check/loginid:
    post:
      tags:
      - Auth
      summary: 로그인 아이디 중복확인
      operationId: checkLoginIdUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckLoginIdRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_CheckLoginIdResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '919':
          description: INVALID_LOGIN_ID
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/auth/check/nickname:
    post:
      tags:
      - Auth
      summary: 닉네임 중복확인
      operationId: checkNicknameUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckNicknameRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_CheckNicknameResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '920':
          description: INVALID_NICKNAME
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/auth/jwt/create:
    post:
      tags:
      - Auth
      summary: 토큰 발급
      operationId: createJWTUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateJwtRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_CreateJwtResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/auth/payco/accessToken:
    get:
      tags:
      - Auth
      summary: 페이코 AccessToken 발급
      operationId: createPaycoAccessTokenUsingGET
      parameters:
      - name: authCode
        in: query
        description: AuthCode
        required: false
        style: form
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_PaycoAccessTokenResponse'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/auth/signin:
    post:
      tags:
      - Auth
      summary: OAuth 로그인
      description: 유저가 존재하면 jwt 내려주고 존재하지않으면 임시회원가입시키고 id_temp_usr 를 내려줌
      operationId: oAuthSignInUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OAuthSignInRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_OAuthSignInResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/auth/signup:
    post:
      tags:
      - Auth
      summary: 회원가입
      operationId: oAuthSignUpUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OAuthSignUpRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_OAuthSignUpResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '914':
          description: ALREADY_SIGNED_UP_USER
        '919':
          description: INVALID_LOGIN_ID
        '920':
          description: INVALID_NICKNAME
      security:
      - Bearer 토큰 값:
        - global
components:
  schemas:
    CheckEmailRequest:
      title: CheckEmailRequest
      type: object
      properties:
        email:
          type: string
    CheckNicknameResponse:
      title: CheckNicknameResponse
      type: object
      properties:
        conflict:
          type: boolean
    CreateJwtRequest:
      title: CreateJwtRequest
      type: object
      properties:
        email:
          type: string
        id_corp:
          type: string
          enum:
          - FACEBOOK
          - GOOGLE
          - KAKAO
          - PAYCO
        phoneNumber:
          type: string
    CheckEmailResponse:
      title: CheckEmailResponse
      type: object
      properties:
        conflict:
          type: boolean
    CheckLoginIdResponse:
      title: CheckLoginIdResponse
      type: object
      properties:
        conflict:
          type: boolean
    CreateJwtResponse:
      title: CreateJwtResponse
      type: object
      properties:
        accessToken:
          type: string
        refreshToken:
          type: string
    OAuthSignUpResponse:
      title: OAuthSignUpResponse
      type: object
      properties:
        access_token:
          type: string
        refresh_token:
          type: string
        token_type:
          type: string
          description: jwt 토큰 타입
    OAuthSignInRequest:
      title: OAuthSignInRequest
      type: object
      properties:
        auth_token:
          type: string
          description: 소셜로그인에서 준 토큰
        cd_corp:
          type: string
          description: 소셜로그인 회사 코드
          enum:
          - FACEBOOK
          - GOOGLE
          - KAKAO
          - PAYCO
    OAuthSignInResponse:
      title: OAuthSignInResponse
      type: object
      properties:
        access_token:
          type: string
          description: Access Token
        email_social:
          type: string
          description: 소셜로그인 에서 받아온 이메일
        id_temp_usr:
          type: string
          description: 임시 유저 아이디
        isEmailAlreadyRegistered:
          type: boolean
          description: 동일한 이메일로 이미 가입된 계정이 있는가
          example: false
        nickname:
          type: string
          description: 유저 닉네임
        refresh_token:
          type: string
          description: Refresh Token
        registeredSocialMediaType:
          type: string
          description: 동일한 이메일로 이미 가입된 소셜 미디어 종류
          enum:
          - FACEBOOK
          - GOOGLE
          - KAKAO
          - PAYCO
        token_type:
          type: string
          description: jwt 토큰 타입
        wincl_user:
          type: boolean
          description: ' wincl 가입자 유무, false 일때 회원가입 프로세스'
          example: false
    WinclResponseData_CheckEmailResponse:
      title: WinclResponseData«CheckEmailResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/CheckEmailResponse'
        message:
          type: string
    WinclResponseData_OAuthSignUpResponse:
      title: WinclResponseData«OAuthSignUpResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/OAuthSignUpResponse'
        message:
          type: string
    WinclResponseData_CheckNicknameResponse:
      title: WinclResponseData«CheckNicknameResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/CheckNicknameResponse'
        message:
          type: string
    WinclResponseData_OAuthSignInResponse:
      title: WinclResponseData«OAuthSignInResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/OAuthSignInResponse'
        message:
          type: string
    WinclResponseData_CreateJwtResponse:
      title: WinclResponseData«CreateJwtResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/CreateJwtResponse'
        message:
          type: string
    CheckLoginIdRequest:
      title: CheckLoginIdRequest
      type: object
      properties:
        id_login:
          type: string
    PaycoAccessTokenResponse:
      title: PaycoAccessTokenResponse
      type: object
      properties:
        access_token:
          type: string
        access_token_secret:
          type: string
        expires_in:
          type: string
        refresh_token:
          type: string
        state:
          type: string
        token_type:
          type: string
    CheckNicknameRequest:
      title: CheckNicknameRequest
      type: object
      properties:
        nickname:
          type: string
    WinclResponseData_PaycoAccessTokenResponse:
      title: WinclResponseData«PaycoAccessTokenResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/PaycoAccessTokenResponse'
        message:
          type: string
    OAuthSignUpRequest:
      title: OAuthSignUpRequest
      type: object
      properties:
        cd_country:
          type: string
          description: 거주국가 코드
        company_code:
          type: string
          description: '회사코드(예: BLC)'
        email:
          type: string
          description: 유저 이메일 (중복 불허)
        id_login:
          type: string
          description: 유저 아이디 (Deprecated)
        id_temp_usr:
          type: string
          description: 임시 유저 아이디
        nickname:
          type: string
          description: 유저 닉네임 (중복 불허)
        verifiedPhoneNumber:
          type: string
          description: '인증된 전화번호 (E.164 포맷. 예: +821012345678)'
    WinclResponseData_CheckLoginIdResponse:
      title: WinclResponseData«CheckLoginIdResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/CheckLoginIdResponse'
        message:
          type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT