WinCL

WinCL Utils API

Utils Controller

GitHub OpenAPI

Operations 7

POST /api/v1/utils/exchange_rate 환율 정보 #
GET /api/v1/utils/nation/list 국가 리스트 #
POST /api/v1/utils/otp/auth OTP 발송 #
POST /api/v1/utils/otp/verify OTP 확인 #
POST /api/v1/utils/sms/message SMS 발송 #
POST /api/v1/utils/submit/partner 파트너 요청 #
POST /api/v1/utils/upload/image 이미지 업로드 #

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-utils-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-utils-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-utils-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Wincl Admin Utils API
  version: '1.0'
  description: Admin Controller
servers:
- url: https://api.wincl.io:443
  description: Inferred Url
tags:
- name: Utils
  description: Utils Controller
paths:
  /api/v1/utils/exchange_rate:
    post:
      tags:
      - Utils
      summary: 환율 정보
      operationId: exchangeRateUsingPOST
      requestBody:
        content:
          multipart/form-data:
            schema:
              required:
              - currency
              type: object
              properties:
                currency:
                  type: string
                  description: Currency
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_ExchangeRate'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/utils/nation/list:
    get:
      tags:
      - Utils
      summary: 국가 리스트
      operationId: nationalListUsingGET_1
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_List_Nation'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/utils/otp/auth:
    post:
      tags:
      - Utils
      summary: OTP 발송
      description: 휴대폰 인증을 위한 OTP 발송하기
      operationId: authOtpUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsAuthyRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_SmsResult'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/utils/otp/verify:
    post:
      tags:
      - Utils
      summary: OTP 확인
      description: 수신한 OTP 번호가 맞는지 확인하기
      operationId: verifyOtpUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsVerifyRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_SmsResult'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/utils/sms/message:
    post:
      tags:
      - Utils
      summary: SMS 발송
      description: SMS 발송하기
      operationId: sendSmsUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SmsMessageRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_SmsResult'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/utils/submit/partner:
    post:
      tags:
      - Utils
      summary: 파트너 요청
      operationId: submitPartnerUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitPartnerRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/utils/upload/image:
    post:
      tags:
      - Utils
      summary: 이미지 업로드
      operationId: uploadImageUsingPOST_1
      requestBody:
        content:
          multipart/form-data:
            schema:
              required:
              - imageFile
              - path
              type: object
              properties:
                imageFile:
                  type: string
                  description: 이미지 파일
                  format: binary
                path:
                  type: string
                  description: S3 파일 Path
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_UploadFileResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer 토큰 값:
        - global
components:
  schemas:
    SmsResult:
      title: SmsResult
      type: object
      properties:
        status:
          type: string
          description: 'Otp 상태. 기대값 = {/otp/auth: `pending`, /otp/verify: `approved`, /sms/message: `accepted`}'
    WinclResponseData_List_Nation:
      title: WinclResponseData«List«Nation»»
      type: object
      properties:
        code:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/Nation'
        message:
          type: string
    WinclResponse:
      title: WinclResponse
      type: object
      properties:
        code:
          type: string
        message:
          type: string
    SmsMessageRequest:
      title: SmsMessageRequest
      type: object
      properties:
        messageContents:
          type: string
          description: 발신할 SMS 내용
        recipientPhoneNumber:
          type: string
          description: '수신자 번호 (E.164 포맷. 예: +821012345678)'
    WinclResponseData_ExchangeRate:
      title: WinclResponseData«ExchangeRate»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/ExchangeRate'
        message:
          type: string
    Nation:
      title: Nation
      type: object
      properties:
        cd_nation:
          type: string
          description: 국가코드 3자리
          example: KOR
        cd_nation2:
          type: string
          description: 국가코드 2자리
          example: KR
        cd_phone:
          type: string
          description: 국제전화 국가번호
          example: '+82'
        corrs_adj:
          type: number
          description: 상응조정률
          format: bigdecimal
          example: 0.3
        nm_en:
          type: string
          description: 국가 영어 이름
        nm_kr:
          type: string
          description: 국가 한글 이름
        num_nation:
          type: integer
          description: 국가코드 숫자
          format: int32
          example: 410
    SmsAuthyRequest:
      title: SmsAuthyRequest
      type: object
      properties:
        recipientPhoneNumber:
          type: string
          description: '수신자 번호 (E.164 포맷. 예: +821012345678)'
    SmsVerifyRequest:
      title: SmsVerifyRequest
      type: object
      properties:
        recipientPhoneNumber:
          type: string
          description: '수신자 번호 (E.164 포맷. 예: +821012345678)'
        verificationCode:
          type: string
          description: SMS로 수신한 인증코드
    WinclResponseData_UploadFileResponse:
      title: WinclResponseData«UploadFileResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/UploadFileResponse'
        message:
          type: string
    UploadFileResponse:
      title: UploadFileResponse
      type: object
      properties:
        url:
          type: string
    WinclResponseData_SmsResult:
      title: WinclResponseData«SmsResult»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/SmsResult'
        message:
          type: string
    ExchangeRate:
      title: ExchangeRate
      type: object
      properties:
        currency:
          type: string
        dttm_reg:
          type: string
          format: date-time
        rate:
          type: number
          format: bigdecimal
    SubmitPartnerRequest:
      title: SubmitPartnerRequest
      type: object
      properties:
        companyName:
          type: string
        contents:
          type: string
        email:
          type: string
        name:
          type: string
        questionCategory:
          type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT