DEXUN Inc Public API

openapi: 3.2.0
info:
  title: 7275 Com Public API
  version: 1.2.0
  contact:
    name: DEXUN INC
    url: https://app.7275.com/contact
    email: service@7275.com
  license:
    name: Proprietary
    identifier: LicenseRef-DEXUN-Proprietary
  description: 'Operations tagged Public across 2 of this provider''s published API definitions: 7275-openapi.json, 7275-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.7275.com/api/v1
  description: Production
security:
- BearerApiKey: []
tags:
- name: Public
  description: Endpoints that take no API key — no auth, no rate limit. Safe to call from front-end code.
paths:
  /changelog:
    get:
      tags:
      - Public
      summary: Public product changelog feed
      description: No auth, no rate limit. Cached for 1 hour with ETag + If-None-Match support. Use `?lang=` (e.g. `zh-CN`, `ja`, `de`) for localized copy; defaults to English. Copy not yet available in a locale falls back to English (Traditional Chinese falls back to Simplified Chinese first).
      security: []
      parameters:
      - name: lang
        in: query
        schema:
          type: string
          enum:
          - en
          - zh-CN
          - zh-TW
          - es
          - pt-BR
          - fr
          - de
          - it
          - ja
          - ko
          - id
          - vi
          - th
          - tr
          - ar
          default: en
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 50
        description: Only return the most recent N entries (1..50). Useful for "what's new since I last updated" widgets that only need the top of the list. Omit for the full list.
      - name: since
        in: query
        schema:
          type: string
          format: date
          pattern: ^\d{4}-\d{2}-\d{2}$
        description: Return only entries whose `date >= since` (YYYY-MM-DD). Stored "last-poll date" + this filter is the canonical pattern for incremental fetches. Applied before `limit`.
      - name: If-None-Match
        in: header
        schema:
          type: string
        description: Pass the ETag from a previous response; 304 if unchanged.
      - name: If-Modified-Since
        in: header
        schema:
          type: string
        description: RFC 7231 HTTP-date. 304 when the newest entry is not newer than this date. ETag is preferred when both are sent (RFC 9110 §13.1).
      responses:
        '200':
          description: OK
          headers:
            ETag:
              schema:
                type: string
              description: Quoted SHA-256 fingerprint of the entry set + lang + limit + since. Differs across locales, limit values, and since values so consumers do not get false 304s on the wrong variant.
            Last-Modified:
              schema:
                type: string
              description: IMF-fixdate of the most recent entry (00:00:00 GMT — we only carry day-level precision in the source data).
            Cache-Control:
              schema:
                type: string
                examples:
                - public, max-age=3600, s-maxage=3600
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChangelogResponse'
        '304':
          description: Not Modified — the entry set has not changed since the supplied ETag.
      operationId: getChangelog
      x-operation-id-source: derived
    servers:
    - url: https://app.7275.com/api/v1
      description: Production
components:
  schemas:
    ChangelogResponse:
      type: object
      required:
      - lang
      - generated_at
      - count
      - entries
      properties:
        lang:
          type: string
          enum:
          - en
          - zh-CN
          - zh-TW
          - es
          - pt-BR
          - fr
          - de
          - it
          - ja
          - ko
          - id
          - vi
          - th
          - tr
          - ar
          description: The locale that was requested (entries not yet translated into it fall back as described on `?lang`).
        generated_at:
          type: string
          format: date-time
        count:
          type: integer
          minimum: 0
        entries:
          type: array
          items:
            $ref: '#/components/schemas/ChangelogEntry'
    ChangelogEntry:
      type: object
      required:
      - date
      - version
      - tags
      - title
      - description
      - bullets
      properties:
        date:
          type: string
          format: date
        version:
          type: string
        tags:
          type: array
          items:
            type: object
            required:
            - kind
            - label
            properties:
              kind:
                type: string
                enum:
                - feature
                - improvement
                - fix
                - security
                - platform
              label:
                type: string
        title:
          type: string
        description:
          type: string
        bullets:
          type: array
          items:
            type: string
        related:
          type:
          - object
          - 'null'
          properties:
            href:
              type: string
            label:
              type: string
  securitySchemes:
    BearerApiKey:
      type: http
      scheme: bearer
      bearerFormat: dxk_<env>_<token>
      description: Generate in /settings/api-keys. Plaintext is shown once at creation; only the SHA-256 hash is stored.
x-refined-from:
- 7275-openapi.json
- 7275-com-openapi.json