Dokumentasi Referensi API Forge
Untuk tim platform yang menghasilkan dokumentasi referensi API yang akurat dari skema, rute, atau catatan endpoint.
Best for these models
๐ The Prompt
๐ Prompt tersedia dalam unduhan
Dapatkan teks prompt lengkap dalam file .txt yang dapat diunduh. Gratis, tanpa pendaftaran.
Unduh PromptVariables to fill in
{{API_SPEC}} โ Replace with your input {{AUTH_METHOD}} โ Replace with your input {{TARGET_READERS}} โ Replace with your input {{EXAMPLE_REQUESTS}} โ Replace with your input {{ERROR_CODES}} โ Replace with your input {{VERSION}} โ Replace with your input About this prompt
Template penghasil dokumentasi API ini mengubah definisi endpoint, file skema, dan catatan implementasi menjadi dokumentasi referensi yang rapi. Dirancang untuk menghasilkan deskripsi endpoint yang konsisten, bidang permintaan dan respons, catatan otentikasi, dan payload contoh. Struktur ini membantu tim mendokumentasikan API lebih cepat sambil menjaga output sesuai kontrak nyata daripada teks pengisi umum.
Ini ideal untuk insinyur platform, tim backend, dan penulis pengalaman pengembang yang memelihara API publik atau internal. Prompt ini mendorong model untuk mencantumkan parameter yang diperlukan, parameter opsional, kode status, dan kesalahan umum dalam format yang dapat dengan cepat disaring oleh pengembang. Mendukung API versi, yang berguna saat Anda memerlukan dokumentasi terpisah untuk v1 dan v2 atau saat deprecations harus disebutkan dengan jelas. Gunakan ini setiap kali skema berubah dan dokumentasi perlu mengikuti tanpa penulisan ulang manual.
Sesuaikan template dengan menyediakan {{API_SPEC}}, {{AUTH_METHOD}}, dan {{TARGET_READERS}}. Tambahkan {{EXAMPLE_REQUESTS}}, {{ERROR_CODES}}, dan {{VERSION}} untuk menghasilkan halaman referensi yang lebih lengkap. Output harus berupa panduan API terstruktur dengan tabel endpoint, contoh permintaan, contoh respons, dan catatan tentang batas kecepatan atau kasus tepi. Untuk hasil terbaik, sertakan URL dasar yang tepat dan konvensi penamaan agar model dapat mencerminkan bentuk dan terminologi API nyata Anda.
Key features
- Dokumentasi endpoint sesuai kontrak dari skema atau catatan rute
- Termasuk panduan otentikasi, kesalahan, dan batas kecepatan
- Ideal untuk tim pengalaman pengembang dan API publik
- Mendukung referensi versi untuk endpoint yang berkembang
- Menghasilkan contoh permintaan dan respons yang realistis
Best for
- โ Insinyur platform yang mendokumentasikan API layanan internal
- โ Penulis pengalaman pengembang yang mengelola portal API publik
- โ Tim backend yang memperbarui dokumentasi setelah perubahan skema atau rute
Tips
- ๐ก Tempel skema OpenAPI terbaru atau definisi rute untuk hasil terbaik.
- ๐ก Tentukan tingkat pembaca untuk mengontrol seberapa banyak terminologi dan penjelasan yang disertakan.
- ๐ก Tambahkan catatan versi dan deprecation saat mendokumentasikan endpoint yang berkembang.
What you'll get
Sebuah referensi API terstruktur dengan gambaran umum, otentikasi, detail endpoint, parameter, contoh permintaan, contoh respons, kesalahan, dan batas kecepatan. Diformat untuk penggunaan langsung di situs dokumentasi atau repositori markdown dan mencerminkan kontrak nyata sedekat mungkin dengan input.
Preparing your download...
Unduh PromptPrompts terkait
Analis Konsultasi Kontrak API
Untuk insinyur yang meninjau perubahan API yang dapat merusak klien, kontrak, atau jaminan kompatibilitas mundur.
API Mock Server Blueprinter
Untuk tim yang membangun layanan palsu yang mensimulasikan perilaku API yang realistis sebelum penyelesaian backend.
Arsitek Fixture Pengujian Backend
Untuk insinyur senior yang membuat fixture dan mock yang dapat digunakan kembali untuk rangkaian pengujian backend yang kompleks.
Decoder Jejak Stack Bug Hunter
Untuk pengembang yang membutuhkan penjelasan cepat dan akurat tentang crash, pengecualian, dan jejak stack dalam kode produksi.