🔌 API ម៉ាស៊ីន​គិតលេខ​ឥត​គិត​ថ្លៃ

ទិដ្ឋភាព​ទូទៅ

API ដំណើរការគណិតវិទ្យាដូចគ្នាដែលគេហទំព័រប្រើ។ ផ្ញើតម្លៃវាលរបស់ម៉ាស៊ីនគិតលេខជាប៉ារ៉ាម៉ែត្រសំណួរឬ JSON ហើយទទួលបានលទ្ធផលគណនាត្រឡប់មកវិញជា JSON - រួមទាំងកាលវិភាគឬទិន្នន័យតារាងនៃការដកប្រាក់ណាមួយដែលម៉ាស៊ីនគិតលេខផលិត។

• 198+ ម៉ាស៊ីន​គិតលេខ មួយ​ៗ​មាន​ចំណុច​បញ្ចប់​របស់​វា
• គ្មាន​កូនសោ API — ការ​ចូល​ដំណើរការ​អនាមិក កំណត់​អត្រា​ដោយ IP
• CORS — Access-Control-Allow-Origin: * (ប្រើ​បាន​នៅ​ផ្នែក​ម៉ាស៊ីន​ភ្ញៀវ)
• ដែន​កំណត់​អត្រា: 60 សំណើ/ម៉ោងក្នុងមួយ IP (HTTP 429 នៅពេលលើសពី)

URL មូលដ្ឋាន

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

លិបិក្រម — រាយ​ម៉ាស៊ីន​គិតលេខ​ទាំងអស់

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

ត្រឡប់​បញ្ជី​ដែល​អាច​អាន​ដោយ​ម៉ាស៊ីន​នៃ​ម៉ាស៊ីន​គិតលេខ​ទាំងអស់​ជាមួយ​វាល​របស់​វា​នីមួយៗ (គ្រាប់ចុច ស្លាក ប្រភេទ លំនាំដើម ឯកតា) និង​គ្រាប់ចុច​លទ្ធផល - គ្រប់គ្រាន់​ដើម្បី​បង្កើត​ម៉ាស៊ីន​ភ្ញៀវ​ដោយ​ថាមវន្ត & # 160; ។

គណនា — រត់​ម៉ាស៊ីន​គិតលេខ​មួយ

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

រាង​ការ​ឆ្លើយតប & # 160; ៖

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

គណនាដែលដឹងអំពីប្រទេស (អចលនទ្រព្យ, ប្រាក់កម្ចី, ពន្ធលើប្រាក់ចំណូល, ពន្ធលើការលក់...) ទទួលយក ?country=us|uk|ca|au|in|ie|nz|za. មិន​ស្គាល់ slug ត្រឡប់ 404 ប្រទេស​ដែល​មិន​គាំទ្រ ឬ​បញ្ចូល​មិន​ល្អ ត្រឡប់ 400 ជាមួយ​សារ​ដែល​មាន​ប្រយោជន៍ និង​ការ​បញ្ជាក់​វាល & # 160; ។

ការ​ផ្ទៀងផ្ទាត់​ភាព​ត្រឹមត្រូវ និង​ផែនការ

អ្នក អាច ហៅ API ដោយ គ្មាន កូនសោ នៅ លើ ទាំងអស់ - សំណើ អនាមិក ត្រូវបាន កំណត់ ដោយ ចំនួន កំណត់ ដោយ IP. សម្រាប់ ខ្ពស់ ជាង នេះ, កូតា ខែ ប្រចាំ ឆ្នាំ ដែល អាច ព្យាករ បាន (និង ការ ប្រើ ពាណិជ្ជកម្ម), បង្កើត កូនសោ នៅលើ ទំព័រ គណនី របស់ អ្នក ហើយ ផ្ញើ វា មួយ នៃ វិធី បី:

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"

• ឥត​គិត​ថ្លៃ — អនាមិក (អត្រា IP កំណត់) ឬ​កូនសោ​ឥតគិតថ្លៃ​ជាមួយ​កូតា​ប្រចាំ​ខែ​តូច ។ មិនមែន​ពាណិជ្ជកម្ម ។
• អ្នកអភិវឌ្ឍន៍ — $9/ខែ — 10,000 ការហៅ/ខែ, ការប្រើពាណិជ្ជកម្ម។
• អាជីវកម្ម — $49/ខែ — 100,000 ការហៅ / ខែ, ចំណាត់ថ្នាក់អាទិភាព.

ពេល​ដែល​កូតា​ប្រចាំ​ខែ​របស់​កូនសោ​ត្រូវ​បាន​ប្រើ​ឡើង API ត្រឡប់ HTTP 429 ជាមួយ​កំហុស "quota_exceeded" កូនសោ​មិន​ស្គាល់ ឬ​អសកម្ម​ត្រឡប់ HTTP 401 ។ មើលផែនការពេញលេញនិងចុះឈ្មោះនៅលើ ការ​កំណត់​តម្លៃ ទំព័រ.

ឧទាហរណ៍

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}'

ចំណុច​បញ្ចប់​ទាំងអស់

ចំណុច​បញ្ចប់​មួយ​ក្នុង​មួយ​ម៉ាស៊ីន​គិតលេខ & # 160; ។ គ្រាប់ចុច​វាល និង​គ្រាប់ចុច​លទ្ធផល​សម្រាប់​រៀង​ៗ​ខ្លួន​គឺ​នៅ​ក្នុង /api/v1/ លិបិក្រម.