Buat token GanttFather API, panggil v1 REST API dengan aman, tangani kuota dan idempotensi, dan pilih antara REST dan MCP.
GanttFather REST API memperlihatkan operasi proyek, tugas, ketergantungan, anggota, dan sumber daya berversi untuk skrip dan integrasi. Autentikasi dengan token GanttFather, kirim header Agen-Pengguna yang tidak kosong, mulai dengan panggilan baca, dan gunakan Kunci Idempotensi saat membuat tugas atau sumber daya yang dapat dicoba ulang.
API perilaku diverifikasi 7 Agustus 2026. Perlakukan referensi langsung API sebagai kontrak tingkat titik akhir.
Apa yang dapat Anda otomatisasi dengan GanttFather API?
API v1 mendukung alur kerja integrasi jadwal yang umum:
- daftar proyek yang dapat diakses dan periksa satu proyek
- membuat daftar dan membaca tugas, anggota, sumber daya, dan dependensi
- membuat, memperbarui sebagian, menyusun ulang, dan menghapus tugas
- menambah atau menghapus dependensi tugas
- membuat, memperbarui, dan menghapus sumber daya
- lampirkan pemetaan Anda sendiri antara catatan eksternal dan id GanttFather
API publik tidak sama dengan API internal browser. Gunakan hanya titik akhir dan bidang respons v1 yang terdokumentasi.
Bagaimana cara membuat dan menggunakan token API?
Buka GanttFather, buka Pengaturan → Agen AI & API, dan buat token dengan cakupan dan izin terkecil yang berguna. Salin token mentah saat ditampilkan dan simpan di manajer rahasia; GanttFather tidak menyimpan nilai mentah untuk ditampilkan nanti.
Kemudian ikuti urutan ini:
- Baca panduan otentikasi.
- Telepon daftar proyek untuk menemukan id proyek yang dapat diakses.
- Baca tugas sebelum mencoba menulis.
- Buat satu tugas tes sekali pakai.
- Tambahkan pagination, coba lagi, dan penanganan kuota sebelum pekerjaan massal.
Setiap permintaan harus menyertakan token Pembawa dan Agen Pengguna yang tidak kosong yang mengidentifikasi klien. Agen Pengguna yang hilang ditolak sebelum penanganan titik akhir normal.
Aturan keselamatan apa yang penting bagi penulis?
Gunakan pembaruan sebagian hanya untuk bidang yang dimiliki integrasi Anda. Baca status saat ini sebelum mengubahnya, catat id stabil dan lacak informasinya, dan jangan ubah setiap bidang eksternal menjadi penimpaan tanpa syarat.
Untuk pembuatan tugas dan sumber daya, kirimkan Kunci Idempotensi ketika batas waktu atau kegagalan jaringan dapat menyebabkan percobaan ulang. Menggunakan kembali kunci dengan permintaan yang sama akan mengembalikan hasil sebelumnya; menggunakannya kembali dengan permintaan yang berbeda adalah sebuah konflik. Pembaruan dan penghapusan memiliki semantik yang terdokumentasi dan tidak menerima kunci khusus buat tersebut sebagai mekanisme deduplikasi universal.
Ketergantungan dan hierarki adalah masalah yang terpisah. Penyusunan ulang adalah cara yang disetujui untuk mengubah penempatan induk; ketergantungan model titik akhir hubungan pendahulunya. Validasi keduanya daripada mengambil salah satu dari yang lain.
Berapa tarif dan batas kuota hariannya?
Perlindungan defaultnya adalah 60 permintaan per menit per token yang diautentikasi dan 5.000 permintaan per hari per token. Respons terbatas menggunakan HTTP 429 dan memberikan informasi percobaan ulang. Periksa arusnya dokumentasi batas tarif dan kuota sebelum merencanakan beban kerja produksi karena batasan operasional dapat berubah.
Kurangi volume permintaan dengan memberi nomor halaman dengan benar, membaca dalam batch, menyimpan id stabil dalam cache, dan mengirimkan satu pembaruan parsial, bukan serangkaian pembaruan per bidang. Perulangan percobaan ulang harus mengikuti Retry-After dan menggunakan backoff eksponensial terbatas dengan jitter.
Kapan sebaiknya Anda menggunakan REST dan bukan MCP?
Gunakan REST ketika kode aplikasi deterministik memerlukan sumber daya berversi HTTP, respons kesalahan eksplisit, dan perilaku percobaan ulang yang terkontrol. Gunakan server MCP ketika klien AI seperti Claude harus memanggil alat proyek tingkat tinggi melalui Model Context Protocol.
Keduanya dapat menggunakan jalur token GanttFather, namun operasi dan masukan idempotensinya tidak dapat dipertukarkan. Integrasi API harus mengikuti referensi REST; agen harus mengikuti deskripsi alat MCP.
Apa pola integrasi pertama yang aman?
Mulailah dengan satu arah dan satu pemilik untuk setiap bidang:
| Langkah | Perilaku yang direkomendasikan |
|---|---|
| Temukan | Daftar proyek dan catat id proyek yang dipilih |
| Baca | Telusuri tugas-tugas saat ini dan buat peta id |
| Bandingkan | Hitung himpunan perubahan tanpa menulis |
| Ulasan | Log yang dimaksudkan untuk pembuatan, pembaruan, dan penghapusan |
| Menulis | Terapkan mutasi terkecil yang didukung |
| Verifikasi | Baca hasilnya dan catat id yang dikembalikan |
Jangan mengklaim “sinkronisasi” sampai konflik kepemilikan, aturan penghapusan, percobaan ulang, dan pemulihan ditentukan.
Kapan sebaiknya Anda mengembangkan GanttFather API?
Gunakan API ketika formulir, alur penerapan, portal pelanggan, atau sistem internal memerlukan akses berulang ke data proyek yang sama yang dilihat tim Anda di GanttFather. Kasus penggunaan pertama yang paling dapat diandalkan adalah kasus yang sempit—misalnya, membuat tonggak rilis setelah penerapan—lalu memperluas setelah mengamati kegagalan nyata dan percobaan ulang.
API tidak menentukan sistem mana yang memiliki suatu bidang atau membuat alur kerja multi-sistem bebas konflik. Integrasi Anda harus menentukan aturan-aturan tersebut.
Buat proyek GanttFather, mengeluarkan token dengan hak istimewa paling rendah, dan menguji data sekali pakai sebelum menghubungkan catatan produksi.
Pertanyaan yang sering diajukan
Apakah akses API termasuk dalam tingkat gratis?
Akses API saat ini tersedia di seluruh paket GanttFather. Batasan kapasitas dan perlindungan masih berlaku; verifikasi halaman harga dan dokumentasi kuota API untuk persyaratan saat ini.
Seperti apa bentuk token GanttFather API?
Token menggunakan format token GanttFather dan disajikan sebagai kredensial Pembawa. Jangan pernah memasukkan token ke kontrol sumber atau memasukkannya ke dalam log publik.
Apakah Agen Pengguna opsional?
Tidak untuk permintaan v1 normal. Kirimkan nilai yang tidak kosong yang mengidentifikasi integrasi Anda, seperti nama dan versi produk.
Haruskah setiap permintaan menyertakan Kunci Idempotensi?
Tidak. Gunakan untuk operasi pembuatan yang terdokumentasi ketika permintaan yang sama dapat dicoba ulang. Ini bukan versi tujuan umum atau header konkurensi.
Bisakah API mengonfigurasi sumber integrasi Azure DevOps?
Data proyek v1 publik API dan integrasi Azure DevOps produk merupakan permukaan yang terpisah. Jangan berasumsi bahwa ada titik akhir integrasi yang tidak terdokumentasi.
Di mana dokumentasi OpenAPI?
Mulai dari GanttFather API perkenalan dan ikuti tautan referensi untuk autentikasi, titik akhir, skema, dan kesalahan.
