pyungyo-com Changes API

openapi: 3.2.0
info:
  title: 평생요금제닷컴 알뜰폰 요금제 Changes API
  version: 2.1.0
  description: '한국 알뜰폰(MVNO) 요금제를 통신사 공식 홈페이지 기준(하루 5번 확인)으로 조회합니다. 인증 없음·읽기 전용. 출처 표기(CC BY 4.0): "평생요금제닷컴(pyungyo.com) 집계, 기준 시각". 가입 전 통신사 화면에서 최종 금액을 확인하세요.'
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/deed.ko
  contact:
    url: https://pyungyo.com/about/
servers:
- url: https://pyungyo.com
tags:
- name: Changes
paths:
  /api/v1/changes:
    get:
      operationId: recentPriceChanges
      summary: 최근 월 요금이 바뀐 요금제
      description: '"이번 주 요금 오른 알뜰폰 있어?", "새로 나온 요금제" 질문용. 최근 N일(기본 7, 최대 60) 동안 월 요금이 오르거나 내린 요금제와 새로 생긴·빠진 요금제를 날짜·전후 요금과 함께 돌려줍니다. 매일 보관한 게시본을 비교한 것이라 통신사 공지에 없는 변동도 잡힙니다.'
      parameters:
      - name: days
        in: query
        required: false
        description: 1~60, 기본 7
        schema:
          type: number
      - name: direction
        in: query
        required: false
        description: up=오른 것만, down=내린 것만
        schema:
          type: string
          enum:
          - up
          - down
          - both
      - name: type
        in: query
        required: false
        description: lifetime=평생 할인·정가(기본) / limited=선착순·기한 한정 가입 / period=N개월 기간 할인 / nodate=종료일 안 적힌 할인 / all=전부
        schema:
          type: string
          enum:
          - lifetime
          - limited
          - period
          - nodate
          - all
      - name: mno
        in: query
        required: false
        description: 빌려 쓰는 통신망
        schema:
          type: string
          enum:
          - SKT
          - KT
          - LGU
      - name: network
        in: query
        required: false
        description: network
        schema:
          type: string
          enum:
          - LTE
          - 5G
      - name: dataMin
        in: query
        required: false
        description: 한 달 데이터 최소 GB (매일 제공은 30일치로 계산, 무제한 포함)
        schema:
          type: number
      - name: brand
        in: query
        required: false
        description: '알뜰폰 통신사 이름 일부 (예: 이야기, 프리티, 헬로)'
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: 오름·내림 각각 최대 1~100, 기본 30
        schema:
          type: number
      - name: format
        in: query
        required: false
        description: text 로 주면 사람이 읽는 글(text/plain)
        schema:
          type: string
          enum:
          - json
          - text
      responses:
        '200':
          description: 바뀐 요금제
          content:
            application/json:
              schema:
                type: object
                properties:
                  source:
                    type: string
                    description: 출처
                  attribution:
                    type: string
                    description: 인용 표기
                  license:
                    type: string
                    description: 이용 조건(CC BY 4.0)
                  asOf:
                    type: string
                    description: 기준 시각(UTC ISO)
                  up:
                    type: array
                    description: 오른 것
                  down:
                    type: array
                    description: 내린 것
            text/plain:
              schema:
                type: string
      tags:
      - Changes
externalDocs:
  url: https://pyungyo.com/developers/