Support

Tanyakan dokumen kami

Tanyakan asisten AI kami yang telah dilatih dengan dokumentasi kami.

Widget dasbor

Kirim pesan kepada kami dari dasbor Anda. Pilih Support di sidebar dasbor Anda.

Email Kami

Jika Anda tidak dapat mengakses dasbor Anda, email kami di [e-mail].

Tanya AI

Bergabunglah dengan komunitas kami dan tanyakan asisten AI kami yang telah dilatih dengan dokumentasi kami.

YouTube

Tonton tutorial dan panduan di channel YouTube kami.

Pertanyaan yang Sering Diajukan

Masalah aplikasi GitHub

Aplikasi GitHub bisa bermasalah dan mereset koneksi adalah cara yang bagus untuk menyelesaikan masalah.

1. Copot pemasangan aplikasi Mintlify melalui GitHub

   1. Di GitHub, pergi ke installations dan pilih Configure di sebelah aplikasi Mintlify. Gulir ke bawah dan pilih Uninstall.
   2. Pergi ke Authorized GitHub Apps dan pilih Revoke di sebelah aplikasi Mintlify.
2. Pasang ulang aplikasi Mintlify

   1. Di dasbor Mintlify Anda, pergi ke Git Settings dan pasang aplikasi GitHub.
   2. Otorisasi akun Anda di bagian My Profile di dasbor Anda.

Masalah halaman API

Halaman API itu rumit. Akibatnya, ada banyak hal yang bisa salah. Berikut adalah daftar masalah umum yang sering dihadapi pelanggan:

Semua halaman OpenAPI saya benar-benar kosong

Dalam skenario ini, kemungkinan besar Mintlify tidak dapat menemukan dokumen OpenAPI Anda atau dokumen OpenAPI Anda tidak valid.

Menjalankan mint dev secara lokal seharusnya mengungkapkan beberapa masalah ini.

Untuk memverifikasi bahwa dokumen OpenAPI Anda akan lulus validasi:

1. Jalankan mint openapi-check <openapiFilenameOrUrl> di CLI Anda.
2. Validasi spesifikasi OpenAPI Anda dengan Swagger Editor.

Selain itu, Mintlify tidak mendukung OpenAPI 2.0. Jika dokumen Anda menggunakan OpenAPI 2.0, Anda mungkin mengalami masalah ini. Anda dapat mengkonversi dokumen Anda dengan Swagger Editor.

Salah satu halaman OpenAPI saya benar-benar kosong

Ini biasanya disebabkan oleh kesalahan ejaan pada bidang openapi di metadata halaman. Pastikan bahwa metode HTTP dan path cocok persis dengan metode HTTP dan path dalam dokumen OpenAPI.

Berikut adalah contoh bagaimana hal-hal bisa salah:

get-user.mdx

---
openapi: "GET /users/{id}/"
---

openapi.yaml

paths:
  "/users/{id}":
    get: ...

Perhatikan bahwa path di bidang openapi memiliki garis miring di akhir, sedangkan path di dokumen OpenAPI tidak.

Masalah umum lainnya adalah kesalahan ejaan nama file. Jika Anda menentukan dokumen OpenAPI tertentu di bidang openapi, pastikan nama filenya benar. Misalnya, jika Anda memiliki dua dokumen OpenAPI openapi/v1.json dan openapi/v2.json, metadata Anda mungkin terlihat seperti ini:

api-reference/v1/users/get-user.mdx

---
openapi: "v1 GET /users/{id}"
---

Permintaan dari API Playground tidak berfungsi

Jika Anda memiliki domain kustom yang dikonfigurasi, ini bisa menjadi masalah dengan reverse proxy Anda. Secara default, permintaan yang dibuat melalui API Playground dimulai dengan permintaan POST ke path /api/request pada situs dokumen. Jika reverse proxy Anda dikonfigurasi untuk hanya mengizinkan permintaan GET, maka semua permintaan ini akan gagal. Untuk memperbaikinya, konfigurasikan reverse proxy Anda untuk mengizinkan permintaan POST ke path /api/request.

Atau, jika reverse proxy Anda mencegah Anda menerima permintaan POST, Anda dapat mengonfigurasi Mintlify untuk mengirim permintaan langsung ke backend Anda dengan pengaturan api.playground.proxy di docs.json. Lihat configurations for the API playground untuk informasi lebih lanjut. Ini kemungkinan akan mengharuskan Anda untuk mengonfigurasi CORS di server Anda, karena permintaan ini sekarang akan datang langsung dari browser pengguna Anda.

Halaman dokumen tidak dapat dimuat (error 404)

Periksa apakah Anda memiliki /api di URL. Ini adalah folder yang dicadangkan di lingkungan produksi, yang menghasilkan error 404.

Masalah menambahkan SVG ke kartu

Kami mendukung jenis SVG tertentu, yang disebut JSX, dan karenanya gambar perlu dikonversi.

1. Gunakan SVGR converter untuk menghasilkan kode SVG yang kompatibel dengan JSX.
2. Salin kode di dalam tag <svg/>.

3. Tempel kode ke dalam kartu Anda. Pastikan Anda hanya menyalin dan menempel kode di dalam tag <svg/>.
4. Anda mungkin perlu mengurangi tinggi dan lebar untuk membuat gambar pas.

Kami berusaha sebaik mungkin untuk menanggapi semua permintaan dalam waktu 24 jam tetapi penundaan mungkin terjadi selama waktu sibuk.