🔌 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)
• Makosa hayana mipaka — Kila mwaka wa 400, 174, 429 na 500, kila kitu hugharimu chochote.

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. Kila shamba pia lina bendera inayotakikana woodya kweli kwa mashamba machache ambayo hayana makosa (hasa) ya kuyapeleka: vikoa kadhaa vya kupigia hesabu vyaweza kupandisha bendera, vingine hujibu 400 bila hiyo.

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":   { ... the values actually computed with ... },
  "results":  { ... computed result keys ... },
  "schedule": { "columns": [...], "rows": [...] } | null,
  "chart":    { "type": "pie", "slices": [...] } | null,
  "defaults_applied": ["tax", "insurance"]
}

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.

Vipawa, kukosa kulipa kodi na makosa

Tuma mashamba unayoyajali. defaults_applied.

Chochote ambacho AP siwezi kutatua kwa unyofu ni kosa, hakuna sufuri kamwe: kipimio kisichoeleweka vizuri, thamani ya aina isiyofaa, chaguo lisilojulikana, au uwanja usio na mpaka (tabaka la tarehe) tarehe ya kuzaliwa haiwezi kudhaniwa). Kila mara 400 ukitaja kijira chenye kuudhi na kufuatisha uwanja mzima ili mteja aweze kujirekebisha.

$ curl "https://calculator.free/api/v1/mortgage/?price=350000&rate=6.5&term=30"
{
  "ok": false,
  "error": "unknown_parameter",
  "message": "Unknown parameter 'term' for calculator 'mortgage'. Did you mean 'years'? ...",
  "unknown_parameters": ["term"],
  "did_you_mean": { "term": "years" },
  "valid_parameters": ["down", "extra", "extra_onetime", "extra_yearly", "hoa",
                       "insurance", "other", "pmi", "price", "rate", "tax", "years"],
  "fields": [ ... ]
}

Ile /api/v1/ Orodha huchapisha ufunguo, chapa, kizio, na kama inahitajika Échekewa vya kutosha kujenga mteja ambaye hafichi kamwe.

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.

Kinacho muhimu ni kiwango chako

Kila kosa liko huru: 400 kwa ajili ya hali ya kutoondolewa vizuri ya parameta, thamani mbaya au uwanja usiokuwapo, 404 kwa sababu ya voofisi isiyojulikana, kadi ya funguo mbaya, 429, na chochote kinachoenda vibaya upande wetu.

Kwa sababu makosa yanaruhusiwa yanazuiwa kwa kiwango kidogo: kama ufunguo mmoja unachochea zaidi ya 200 Akikataa majibu kwa saa moja, inapata HTP 429 "Nooyeo_invaid_requests" mpaka saa inapopita. wito wenye mafanikio hautahesabu kamwe, kwa hiyo uunganishaji wa kazi hautaona kamwe kuwa ni wateja tu wanaokwama katika njia ya kujirudisha.

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);

Python

import requests

r = requests.get("https://calculator.free/api/v1/mortgage/",
                 params={"price": 350000, "down": 70000,
                         "rate": 6.9, "years": 30},
                 headers={"Authorization": "Bearer YOUR_KEY"})
print(r.json()["results"])

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.