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

Επισκόπηση

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

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

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

Οι αριθμομηχανές χώρας (δωρεάν, δάνειο, φόρος εισοδήματος, φόροι πωλήσεων...) δέχονται ?country=us|uk|ca|au|in|ie|nz|za. Άγνωστο γυμνοσάλιαγκας επιστρέφει 404; μη υποστηριζόμενη χώρα ή κακή εισαγωγή επιστρέφει 400 με ένα χρήσιμο μήνυμα και το πεδίο spec.

Παράμετροι, προεπιλογές και σφάλματα

Στείλτε μόνο τα πεδία που σας ενδιαφέρει. Οτιδήποτε αφήσετε έξω είναι γεμάτο με ότι το πεδίο έχει δημοσιευθεί προεπιλογή.. την ίδια τιμή η σελίδα υπολογιστή pre-fills, έτσι ώστε το API και η ιστοσελίδα πάντα επιστρέφουν τους ίδιους αριθμούς για τις ίδιες εισροές. defaults_applied.

Οτιδήποτε δεν μπορεί να επιλύσει ειλικρινά είναι ένα σφάλμα, ποτέ ένα μηδέν: μια παραμέτρο που λανθασμένα γράφεται, μια τιμή του λάθος τύπου, μια άγνωστη επιλογή πτώσης, ή ένα πεδίο που λείπει που δεν έχει προεπιλεγμένη (τα πεδία ημερομηνίας ~ μια ημερομηνία γέννησης δεν μπορεί να μαντευτεί). Κάθε 400 ονόματα η παράμετρος προσβλητικό και αντηχεί το πλήρες πεδίο spec έτσι ώστε ένας πελάτης να μπορεί να διορθώσει τον εαυτό του.

$ 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": [ ... ]
}

Η /api/v1/ Ο δείκτης δημοσιεύει το κλειδί κάθε πεδίου, τον τύπο, τη μονάδα, την προεπιλογή και αν απαιτείται □ αρκετά για να χτίσει έναν πελάτη που ποτέ δεν μαντεύει.

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

Μπορείτε να καλέσετε το 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 κλήσεις/μήνα, προτεραιότητα μέσω.

Αυτό που μετράει είναι το ποσοστό σου.

Μόνο μια επιτυχής απάντηση κάνει. Ένα 2xx = μία κλήση. Κάθε σφάλμα είναι δωρεάν: ένα 400 για μια λανθασμένη παράμετρο, μια κακή τιμή ή ένα χαμένο απαιτούμενο πεδίο, ένα 404 για μια άγνωστη σφαίρα, ένα 401 για ένα κακό κλειδί, ένα 429, και οτιδήποτε πηγαίνει λάθος στο πλευρό μας. Εξερευνήστε το συμβόλαιο και να διορθώσετε το αίτημά σας όσες φορές χρειάζεστε.

Επειδή τα λάθη είναι ελεύθερα, είναι περιορισμένα με ρυθμό: αν ένα κλειδί προκαλεί περισσότερο από 200 απόρριψη απαντήσεων σε μια ώρα, παίρνει HTTP 429 "too_many_invalid_requests" μέχρι την ώρα ρολόι πάνω. Επιτυχείς κλήσεις ποτέ δεν μετράνε προς αυτό, έτσι ώστε μια ολοκλήρωση εργασίας δεν θα το δει ποτέ ~ πιάνει μόνο έναν πελάτη κολλημένο σε ένα βρόχο εκ νέου δοκιμή.

Όταν χρησιμοποιείται η μηνιαία ποσόστωση ενός κλειδιού, το 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);

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

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

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