Mengenai penyenaraian ini
Di mana kebanyakan dokumentasi API tersilap langkah
Banyak panduan menyenaraikan titik akhir tetapi mengetepikan butiran yang sebenarnya menimbulkan kekeliruan: cara pengesahan berfungsi secara praktikal, contoh permintaan dan respons yang tepat, serta maksud ralat tertentu dan cara menyelesaikannya. Apabila ini berlaku, pembangun terpaksa menghantar tiket sokongan, yang menggagalkan tujuan mengadakan dokumentasi.
Pendekatan kami
Kami membina terus daripada kod sumber anda dan bukannya bergantung pada andaian. Kami memeriksa laluan, logik pengesahan dan pengendalian ralat anda, sebelum menguji API itu sendiri menggunakan kelayakan langsung. Setiap contoh dalam dokumentasi akhir mewakili permintaan tulen yang kami hantar dan respons yang kami terima, memastikan tiada butiran rekaan atau kod status yang mustahil.
Perkara yang anda terima
- Panduan pengesahan: pengeluaran token, penyegaran semula, dan perkara yang berlaku jika ia luput di pertengahan sesi.
- Liputan penuh bagi setiap titik akhir, termasuk parameter, contoh permintaan yang berfungsi dan struktur respons yang tulen.
- Rujukan ralat yang menghubungkan setiap kod kepada puncanya dan penyelesaiannya, bukan sekadar mesej yang dinyatakan semula.
- Laluan permulaan pantas yang direka untuk membawa pembangun baharu daripada tiada apa-apa kepada panggilan yang berjaya.
- Nota tentang had kadar, penomboran halaman, webhook dan keidempotenan di mana-mana ia berkaitan.
Format penyerahan
Kami membekalkan Markdown yang sesuai untuk repositori anda, berstruktur supaya ia memadankan OpenAPI atau tapak dokumentasi, mana-mana yang akan dipastikan sentiasa dikemas kini oleh pasukan anda. Sampel kod disediakan dalam bahasa yang digunakan oleh pengguna anda dan diuji dengan menjalankannya. Koleksi gaya Postman boleh disertakan atas permintaan.
Perkara yang kami perlukan daripada anda
Akses kepada repositori atau fail OpenAPI anda, kelayakan yang berfungsi untuk persekitaran ujian, dan soalan yang paling kerap dijawab oleh kakitangan sokongan anda - ini membentuk struktur panduan tersebut.
Perkara yang dikecualikan
Perkhidmatan ini merangkumi dokumentasi teknikal yang tepat tentang cara perisian beroperasi; teks promosi atau pemasaran ialah tugasan yang berasingan.
Proses dan masa
Anda akan menerima draf pertama yang lengkap, yang boleh anda semak terhadap soalan lazim yang dikendalikan oleh pasukan sokongan anda. Kami lebih suka jurutera menandakan kes luar biasa lebih awal daripada menyerahkan sesuatu yang kemas tetapi tidak tepat. Oleh kerana setiap contoh telah dijalankan terhadap API langsung anda, tiada apa-apa dalam dokumen akhir yang bersifat teori semata-mata.
Pakej ini merangkumi satu skop dokumentasi API harga tetap yang diserahkan dalam satu hantaran, dengan satu pusingan semakan, untuk 500.99 USD dan tempoh penyelesaian 10 hari. Anda perlu membekalkan domain yang berkaitan dengan pesanan tersebut serta taklimat anda.