Kuota & Batas Laju

API FreeMaint memberlakukan kuota harian per perusahaan, di-reset pada tengah malam UTC. Batasnya bergantung pada paket Anda; penghitung dan sisa kuota diekspos sebagai header respons.

Batas harian

• Core, Starter — 0 (kunci API memerlukan Business)
• Business — 5.000 panggilan/hari (GraphQL dan endpoint pengambilan data energi berbagi penghitung yang sama)
• Enterprise — 100.000 panggilan/hari
• On-Premise — tanpa batas (batas = null)

Header respons

• X-RateLimit-Limit — batas harian paket Anda
• X-RateLimit-Remaining — sisa panggilan hari ini (berkurang pada setiap panggilan yang dihitung kuota)
• X-RateLimit-Reset — stempel waktu Unix untuk tengah malam UTC (reset berikutnya)

Apa yang tidak dihitung

Hanya /public-api/whoami yang gratis: ia tidak mengurangi penghitung Anda, jadi Anda bisa memverifikasi kunci dan paketnya tanpa menghabiskan kuota. Semua yang lewat /api/v1/graphql dihitung, termasuk kueri whoami, begitu pula endpoint pengambilan data energi.

Apa yang dihitung sebagai satu panggilan

Penghitung bertambah per OPERASI, bukan per permintaan HTTP. Menggabungkan 50 mutasi beralias dalam satu permintaan tetap menghabiskan 50 unit. Jadi penggabungan menghemat perjalanan jaringan, bukan kuota. Agar sinkronisasi berkala tetap murah, ambil hanya yang berubah dengan parts(updatedSince: "...") alih-alih membaca ulang seluruh katalog.

Saat Anda melebihi batas

Begitu kuota harian tercapai, setiap panggilan berikutnya ditolak dengan pesan 'Daily API cap reached'. Pada permukaan REST (/public-api/ping, endpoint pengambilan data energi) itu berupa HTTP 403. Pada GraphQL status HTTP-nya 200 dan penolakan berada di errors[0].extensions.code = FORBIDDEN, dengan originalError.statusCode = 403. Penghitung disetel ulang pada 00:00 UTC. Tidak ada batas lunak, jatah lonjakan, atau jendela per menit — jendelanya adalah satu hari.