swagger-api / swagger-api/swagger-codegen

[HTML] Unable to generate html client using editor2.swagger.io

Open
#8,254 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Mustache
Stars
17.8k
Forks
6k
PR merge metrics
No merged PRs in 30d

Description

Description

Unable to generate html client using editor2.swagger.io

Swagger-codegen version

I am using Swagger Editor Version 2.10.4

Swagger declaration file content or url
swagger: '2.0'
info:
  description: |
    Netsmart Patient Eligibility Service
    API provides for
     * Real Time Eligibility checks via query input. (MVP)
     * Insurance list retrieval from clearing house. (MVP)
     * Real Time Eligibility checks via single patient x12 270 file.
     * Batch Eligibility Submisson via x12 270 file format.
     * Batch Response for submitted x12 270 files.
     
  version: 1.0.0
  title: Netsmart Patient Eligibilty API
host: api.ntst.com
basePath: /v1
schemes:
  - http
paths:
  /eligibilities:
    get:
      tags:
        - RealTime
      summary: Real Time Eligibility Check via query parameter (MVP)
      description: ''
      operationId: CheckPat
      consumes:
        - application/json
      produces:
        - application/json
      parameters:
        - in: query
          name: contractNumber
          description: Patient Insurance Contract Number. (Is this contract number unique aross all insurances otherwise we have to pass insurance id)
          required: true
          type: string
        - in: query
          name: lastName
          description: Patient Last Name
          required: true
          type: string
        - in: query
          name: firstName
          description: Patient First Name
          required: false
          type: string
        - in: query
          name: dob
          description: Patient DOB *in mm/dd/yyy format?*
          required: false
          type: string
        - in: query
          name: requestingEntityName
          description: Requesting Entity Name
          required: false
          type: string
        - in: query
          name: requestingEntityNPI
          description: Requesting Entity National Provider ID
          required: false
          type: string
      responses:
        '200':
          description: successful operation
          schema:
            type: object
            properties:
              IsEligible:
                type: boolean
              EligibilityDetails:
                type: string
              ErrorMsg:
                type: string
              ClearingHouseTraceID:
                description: Internal Ability transaction ID for debug purposes
                type: string
        '400':
          description: bad request
        '401':
          description: unauthorized
        '500':
          description: internal server error
  /insurances:
    get:
      tags:
        - Insurances
      summary: Get Insurance Agencies List from clearinghouse (MVP)
      description: Get Ability Insurance List for Eligibility checks
      operationId: getInsList
      produces:
        - application/json
      parameters:
        - in: query
          name: includeenrollmentrequired
          description: Indicate whether to include Enrollment Required Insurances
          required: false
          type: boolean
      responses:
        '200':
          description: successful operation
          schema:
            type: object
            items:
              type: object
              properties:
                InsuranceID:
                  type: string
                InsuranceName:
                  type: string
                EnrollReq:
                  type: boolean
        '400':
          description: bad request
        '401':
          description: unauthorized
        '500':
          description: internal server error
  /eligibilities/batch:
    post:
      tags:
        - Batch
      summary: Batch submission for Eligibility Check (DO WE NEED THIS FOR MVP)
      description: ''
      operationId: submitBatch
      consumes:
        - application/edi-x12
      produces:
        - application/json
      parameters:
        - in: query
          name: 270Data
          description: x12 270 Eligibililyt file
          required: true
          type: string
        - in: query
          name: clientTraceID
          description: client's trace id for batch request
          required: true
          type: string
      responses:
        '200':
          description: successful operation
          schema:
            type: object
            properties:
              BatchID:
                description: Ability ID for response retrieval of submitted 270 batch file
                type: string
              TraceID:
                description: Internal Ability transaction ID for debug purposes
                type: string
    get:
      tags:
        - Batch
      summary: Request response for submitted batch x12 270 file. (DO WE NEED THIS FOR MVP)
      description: Retrieve 271 file from Ability for submitted batch 270
      operationId: getBatchResponse
      produces:
        - application/json
      parameters:
        - in: query
          name: BatchId
          description: ID of submitted x12 270 file
          required: true
          type: string
      responses:
        '200':
          description: successful operation
          schema:
            type: string
        '201':
          description: Batch ID not found
Command line used for generation

In editor2, import YAML file and then Generate Client->HTML

Related issues/PRs
Suggest a fix/enhancement

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in editor2.swagger.io by importing the provided YAML file and selecting Generate Client → HTML. Compare this behavior with the expected generated HTML client; done means the supplied Swagger definition can generate that client successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.