# OpenAPI ke TypeScript

Buat tipe TypeScript dari schema dalam dokumen OpenAPI 3 atau Swagger 2.0 dalam YAML atau JSON. Setiap entri di bawah components.schemas, atau definitions dalam Swagger 2.0, menjadi antarmuka atau alias tipe ekspor, tautan $ref di antaranya menjadi nama tipe, dan bidang nullable mendapat | null.

## Pertanyaan yang sering diajukan

### Bagian dokumen mana yang dikonversi?

Schema di bawah components.schemas dalam OpenAPI 3 dan di bawah definitions dalam Swagger 2.0. Paths, parameter, dan respons tidak diubah menjadi tipe; gunakan tipe schema yang dihasilkan dalam kode permintaan dan respons Anda sendiri.

### Bagaimana nama schema diubah menjadi nama tipe?

Setiap kunci schema dibentuk ulang dalam PascalCase, jadi user-profile menjadi UserProfile. Jika dua kunci menghasilkan nama yang sama, nama kedua diberi tambahan angka.

### Apakah bidang nullable didukung?

Ya. nullable: true dari OpenAPI 3.0 dan x-nullable: true dari Swagger 2.0 menambahkan | null, sedangkan array type OpenAPI 3.1 seperti ["string", "null"] menjadi string | null.

### Apa yang terjadi pada referensi yang tidak dapat diselesaikan oleh alat?

$ref yang mengarah ke luar dokumen, atau ke sesuatu selain schema di components.schemas atau definitions, menjadi unknown dan dicantumkan dalam komentar di bagian atas output.

### Apakah YAML didukung?

Ya. Tempel dokumen sebagai YAML atau JSON. Anchor dan alias dalam YAML diperluas sebelum konversi.

### Bagaimana cara memeriksa dokumen terlebih dahulu?

Gunakan Validator OpenAPI, yang mencantumkan masalah struktural dan referensi yang rusak. Konverter ini hanya membaca schema dan tidak melaporkan kesalahan lain.

Iklan Anda di sini?

[Email kami](mailto:hi@dennn.is?subject=Beriklan%20di%20OneClick%20Pro)

[Iklan 433 alat untuk agen AI Anda melalui satu server MCP.](https://multitaskai.com/id/?ref=oneclickpro)
