🔌 Mhesabu Huru API

Muhtasari

Anuari ya API inaendesha hesabu ileile ambayo tovuti hiyo inatumia.

• 198+ Mashine za kupigia hesabu, kila moja ikiwa na ncha yake yenyewe
• Hakuna Ufunguo wa MILI — Upatikanaji usiofahamika, kiwango cha juu kinachowekwa na IP
• CORS — Access-Control-Allow-Origin: * (Mja anapo sali?)
• Mpaka wa takwimu: 60 maombi/saa kwa IPP (HTP 429 wakati imepitwa)

Base URUL

https://calculator.free/api/v1/

Index É Andika orodha ya kila kifaa cha kupigia hesabu

GET https://calculator.free/api/v1/

Arudisha orodha ya mahujati yote yenye kunyumbuka ya hesabu yenye mashamba (ke, kibandiko, chapa, bila kulipa, kizio) na kutokeza funguo za kutosha kujenga mteja kwa nguvu.

Compereta bustanini

GET  https://calculator.free/api/v1/<slug>/?field=value&field=value
POST https://calculator.free/api/v1/<slug>/     (JSON or form body)

Umbo la mwitikio:

{
  "ok": true,
  "slug": "mortgage",
  "country": "us",
  "inputs":   { ... echoed field values ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null
}

Mashine za kupiga hesabu za mashambani (moge, mkopo, kodi ya mapato, bei ya mauzo...) zinakubali ?country=us|uk|ca|au|in|ie|nz|za. Poover mwenye kujulikana hurudi tena 404; nchi isiyotegemezwa au mbaya hurudi 400 kwa ujumbe wenye kusaidia na uwanja wa mchezo.

Kufasiri kwa Kupe; mipango

Unaweza kuiita API isiyo na ufunguo wowote wa maombi ya ki-Bolywitz yamewekewa viwango vya juu na IP. Kwa kiasi cha juu cha kila mwezi, kinachotarajiwa (na matumizi ya kibiashara), fanyiza ufunguo kwenye ukurasa wako wa akaunti na uitume moja ya njia tatu:

GET  https://calculator.free/api/v1/mortgage/?price=350000&key=YOUR_KEY
curl -H "Authorization: Bearer YOUR_KEY" "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"
curl -H "X-Api-Key: YOUR_KEY"           "https://calculator.free/api/v1/bmi/?units=metric&height=180&weight=80"

• Huru — Si jina (IP imaged-lited) au ufunguo wa bure wenye kiwango kidogo cha mwezi.
• Deazer &medash; Sh.9/mo — 10,000 hupiga simu/Mwezi, matumizi ya kibiashara.
• Biashara &mash; 49/mo — Watu 100,000 wanampigia simu/miezi, weka alama ya kwanza.

Wakati ufunguo unapotumiwa kila mwezi kurudisha HTP429 kwa makosa "yanayopatikana_exa_exceed"; ufunguo usiojulikana au usiotenda unarudi HTPFCOT. Tazama utaratibu na muutie sahihi. Usanii ukurasa.

Vielelezo

curl

curl "https://calculator.free/api/v1/mortgage/?price=350000&down=70000&rate=6.9&years=30"

JavaScript fetch()

const r = await fetch(
  "https://calculator.free/api/v1/bmi/?" + new URLSearchParams({
    units: "metric", height: "180", weight: "80"
  }));
const { results } = await r.json();
console.log(results.bmi, results.category);

POST JSON

curl -X POST "https://calculator.free/api/v1/income-tax/?country=uk" \
  -H "Content-Type: application/json" \
  -d '{"income": 60000}'

Sehemu zote za mwisho

Fungu moja la kila dolia - hesabu. Funguo la Ufunzi na hutokeza funguo za kila mmoja wako katika hizo /api/v1/ Faharisi.