Cerere și răspuns
Orice discuție cu un API are două părți: întrebarea trimisă și răspunsul primit înapoi.
Explicat simplu
Ce este un API?
Un API este o „ușă” prin care un program cere ceva altui program și primește un răspuns, fără să știe cum lucrează acesta înăuntru. Mai jos e explicat pe îndelete, fără termeni tehnici.
O analogie
Gândește-te la un restaurant
Stai la masă și alegi din meniu. Nu intri în bucătărie: îi spui ospătarului ce vrei, iar el îți aduce mâncarea. Ospătarul este API-ul.
Tuaplicația ta
OspătarulAPI-ul
Bucătăriaserviciul care face munca
Meniul arată tot ce poți cere. La Lumos API, în el găsești operațiuni precum „calculează taxele unui PFA” sau „verifică dacă un mesaj e fraudă”.
Pas cu pas
Ce se întâmplă când folosești un API
Aplicația trimite o cerere
De exemplu: „cât net rămâne unui PFA cu venit de 120.000 de lei și cheltuieli de 30.000 de lei?”
API-ul verifică cine ești
Cererea poartă o cheie, ca un card de acces. Fără cheie sau fără credite, cererea nu trece.
Serviciul face munca
Calculul se face la noi, cu regulile fiscale la zi. Aplicația ta nu trebuie să le știe.
Vine răspunsul
Aplicația primește rezultatul (28.035 de lei taxe, 61.965 de lei rămân) și îl arată mai departe utilizatorului.
Cererea și răspunsul, pe scurt
→ POST /v1/taxaro/calculations
{ "form": "pfa_real", "annual_income": 120000, "expenses": 30000 }
← { "total_taxes": 28035, "net_take_home": 61965 }Cifrele sunt calculate de TaxaRO. Exemplul complet e pe prima pagină.
Cuvinte
Cuvintele pe care le vei auzi
Sunt doar câteva. Fiecare are o explicație de o propoziție.
Adresă (endpoint)
Locul unde trimiți cererea. Fiecare adresă face un singur lucru, de exemplu „calculează taxele”.
Cheie API
O parolă lungă, doar a ta, care arată cine face cererea. Se ține secretă.
JSON
Formatul în care circulă datele: text simplu, cu nume și valori, pe care îl înțelege orice program.
Credit
Unitatea în care plătești la Lumos API. Fiecare operațiune costă un număr fix de credite.
MCP
Un fel de API făcut pentru asistenții AI: un asistent, de exemplu Claude, poate cere singur ce are nevoie.
De ce
De ce să folosești un API
Mereu la zi
Regulile și datele se schimbă. Cu un API nu mai refaci nimic: răspunsul vine cu regulile de acum.
Nu refaci munca
Calculele grele și verificările sunt deja făcute și testate. Le ceri, nu le scrii din nou.
Totul merge singur
Programul tău cere răspunsul când are nevoie, fără să mai deschidă cineva un site și să copieze cifre.
Exemple
Ce ai putea face cu Lumos API
- un program de contabilitate care arată singur taxele unui client;
- o aplicație care avertizează oamenii când primesc un mesaj de fraudă;
- un consultant care caută rapid programe de finanțare potrivite unei firme;
- un asistent AI care răspunde cu cifre reale, nu inventate.
FAQ
Întrebări frecvente
Trebuie să știu să programez?
De obicei, un dezvoltator leagă API-ul de aplicația ta. Dacă ai nevoie doar de rezultate, le găsești gratuit pe site-urile Lumos, de exemplu pe TaxaRO. Mai târziu vei putea folosi serviciile și dintr-un asistent AI, fără să scrii cod.
Cât costă?
Plătești în credite, pe care le cumperi în avans, și primești câteva gratuite în fiecare lună. Prețul unui credit nu e stabilit încă.
Ce se întâmplă cu datele mele?
Nu salvăm conținutul cererilor tale. Păstrăm doar cine a făcut apelul, ce operațiune a fost, cât a costat și cât a durat.
Cât de sigure sunt rezultatele?
Sunt orientative: nu înlocuiesc un contabil, un avocat sau un consultant. Fiecare răspuns arată ce reguli a folosit și de când sunt datele.
Este deja disponibil?
Nu încă. Lumos API este în pregătire; poți intra pe lista de așteptare și îți scriem o singură dată, când se deschide.
Vrei să afli când se deschide?
Lasă-ne adresa de email și te anunțăm când poți începe.