🔌 Δωρεάν υπολογιστής API

Επισκόπηση

Η API τρέχει ακριβώς τα ίδια μαθηματικά που χρησιμοποιεί η ιστοσελίδα. Στείλτε τιμές πεδίου ενός υπολογιστή ως παραμέτρους ερώτημα ή JSON και να πάρει τα υπολογισμένα αποτελέσματα πίσω όπως JSON

• 198+ αριθμομηχανές, το καθένα με το δικό του τελικό σημείο
• Δεν υπάρχει κλειδί API — ανώνυμη πρόσβαση, ποσοστό που περιορίζεται από την ΠΕ
• CORS — Access-Control-Allow-Origin: * (χρησιμοποιήσιμη πλευρά πελάτη)
• Όριο επιτοκίου: 60 αιτήσεις/ώρα ανά ΠΕ (HTTP 429 όταν σημειώνεται υπέρβαση)

URL βάσης

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

Δείκτης

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

Επιστρέφει μια λίστα με όλα τα πεδία του κάθε υπολογιστή με δυνατότητα ανάγνωσης με μηχανή (κλειδί, ετικέτα, τύπος, προεπιλογή, μονάδα) και αποτέλεσμα αρκετά για να κατασκευάσει έναν πελάτη δυναμικά.

Υπολογίστε

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

Σχήμα απόκρισης:

{
  "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. Άγνωστο γυμνοσάλιαγκας επιστρέφει 404; μη υποστηριζόμενη χώρα ή κακή εισαγωγή επιστρέφει 400 με ένα χρήσιμο μήνυμα και το πεδίο spec.

Αυθεντικότητα & σχέδια

Μπορείτε να καλέσετε το API χωρίς κανένα κλειδί σε όλα

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/mo — 10.000 κλήσεις/μήνα, εμπορική χρήση.
• Business — $49/mo — 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}'

Όλα τα τελικά σημεία

Ένα τελικό σημείο ανά υπολογιστή. Τα κλειδιά πεδίου και τα αποτελέσματα για κάθε είναι στην /api/v1/ Δείκτης.