PortOne · OpenAPI Overlay 1.0.0

API Evangelist enhancements for PortOne V2

2 actions 2 updates update extends openapi/portone-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for PortOne's API. It is a proposal applied on top of the contract, not a document PortOne publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-generationx-apievangelist-authx-apievangelist-webhooksx-apievangelist-conventionsx-apievangelist-errorsx-apievangelist-idempotencyx-apievangelist-mcp

Targets 2

$.info

$.servers

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for PortOne V2
  version: 1.0.0
# PROVENANCE
# generated: '2026-07-17'
# method: generated
# source: openapi/portone-openapi.yml
# Non-destructive Overlay 1.0.0 capturing API Evangelist enrichment metadata for the
# harvested PortOne V2 spec. Does not mutate the upstream OpenAPI; apply with an
# Overlay-aware tool to produce an annotated copy.
extends: openapi/portone-openapi.yml
actions:
  - target: $.info
    update:
      x-apievangelist-provider: portone
      x-apievangelist-generation: v2
      x-apievangelist-auth: 'Authorization: PortOne <API_SECRET> | Bearer <JWT>'
      x-apievangelist-webhooks: asyncapi/portone-webhooks.yml
      x-apievangelist-conventions: conventions/portone-conventions.yml
      x-apievangelist-errors: errors/portone-problem-types.yml
      x-apievangelist-idempotency: client-assigned resource key (paymentId)
      x-apievangelist-mcp: mcp/portone-mcp.yml
      x-apievangelist-sdks:
        - "@portone/server-sdk (npm/jsr)"
        - portone-server-sdk (PyPI)
        - io.portone:server-sdk (Maven, JVM)
        - "@portone/browser-sdk (npm)"
  - target: $.servers
    update:
      - url: https://api.portone.io
        description: PortOne V2 production (운영환경)
      - url: https://api.iamport.kr
        description: PortOne V1 legacy (Iamport) — maintenance only