Kuota & Had Kadar

API FreeMaint menguatkuasakan kuota harian setiap syarikat, reset pada tengah malam UTC. Had bergantung kepada peringkat anda; kaunter dan baki didedahkan sebagai pengepala respons.

Had harian

• Core, Starter — 0 (kunci API memerlukan Business)
• Business — 5,000 panggilan/hari (GraphQL dan titik akhir pengambilan data tenaga berkongsi pembilang yang sama)
• Enterprise — 100,000 panggilan/hari
• On-Premise — tanpa had (had = null)

Pengepala respons

• X-RateLimit-Limit — had harian peringkat anda
• X-RateLimit-Remaining — baki panggilan hari ini (berkurang pada setiap panggilan yang dikira kuota)
• X-RateLimit-Reset — cap masa Unix tengah malam UTC (reset seterusnya)

Apa yang tidak dikira

Hanya /public-api/whoami yang percuma: ia tidak mengurangkan pembilang anda, jadi anda boleh mengesahkan kunci dan pelannya tanpa menghabiskan kuota. Segala yang melalui /api/v1/graphql dikira, termasuk pertanyaan whoami, begitu juga titik akhir pengambilan data tenaga.

Apa yang dikira sebagai satu panggilan

Pembilang bertambah bagi setiap OPERASI, bukan bagi setiap permintaan HTTP. Menghimpunkan 50 mutasi beralias dalam satu permintaan tetap menggunakan 50 unit. Jadi penghimpunan menjimatkan perjalanan rangkaian, bukan kuota. Supaya penyegerakan berkala kekal murah, ambil yang berubah sahaja dengan parts(updatedSince: "...") dan bukan membaca semula seluruh katalog.

Apabila anda melebihi had

Sebaik sahaja had harian dicapai, setiap panggilan seterusnya ditolak dengan mesej 'Daily API cap reached'. Pada permukaan REST (/public-api/ping, titik akhir pengambilan data tenaga) itu ialah HTTP 403. Pada GraphQL status HTTP ialah 200 dan penolakan berada dalam errors[0].extensions.code = FORBIDDEN, dengan originalError.statusCode = 403. Pembilang ditetapkan semula pada 00:00 UTC. Tiada had lembut, elaun lonjakan atau tetingkap per minit — tetingkapnya ialah satu hari.