Ce este un API și de ce contează când cumperi orice program

API înseamnă, pe scurt, ușa prin care un program poate cere ceva altui program. Nu prin interfața pe care o vezi tu, ci direct, automat, fără om la mijloc.

Analogia cu restaurantul

Stai la masă. Nu intri în bucătărie să îți iei mâncarea și nici bucătarul nu vine să te întrebe ce vrei. Există un chelner și un meniu: tu ceri din meniu, chelnerul duce comanda, bucătăria pregătește, chelnerul aduce.

API-ul e chelnerul plus meniul. Meniul spune ce poți cere — „dă-mi lista de comenzi din ultima lună”, „adaugă un client nou”. Chelnerul duce cererea și aduce răspunsul. Bucătăria rămâne închisă, și e mai bine așa: nu trebuie să știi cum funcționează, și nu poți strica nimic.

Cum arată în practică

Trei situații obișnuite, toate rezolvate prin API:

• Magazinul online trimite automat comanda către programul de facturare. Nimeni nu retastează.
• Aplicația de teren marchează lucrarea terminată, iar sistemul de gestiune știe imediat.
• Site-ul afișează stocul real, pentru că întreabă depozitul de fiecare dată, nu o dată pe zi.

Fără API, toate trei se fac cu un om care copiază dintr-un ecran în altul. Funcționează — până crește volumul.

Întrebările de pus înainte să cumperi orice program

1. Are API și pot vedea documentația acum? Dacă răspunsul e „da, sigur” dar documentația nu apare, probabil nu există.
2. Ce se poate face prin API și ce nu? Multe sisteme permit doar citirea. Dacă vrei să și scrii, întreabă explicit.
3. Costă separat? Unii furnizori pun accesul într-un pachet superior. Bine de aflat înainte, nu după.
4. Există limite? Câte cereri pe minut, câte pe zi. Contează dacă vrei sincronizare în timp real.
5. Ce se întâmplă când se schimbă? Un furnizor serios anunță din timp și ține versiunea veche o perioadă.

Semnul că un furnizor nu vrea să pleci

Un sistem fără API, sau cu unul care permite doar citit, e o formă politicoasă de captivitate. Datele sunt ale tale, dar nu le poți muta fără să le retastezi.

De aceea întrebarea despre API nu e tehnică, ci comercială: e despre cât de ușor poți schimba furnizorul peste trei ani.

Ce merge prost la integrări

Cele două sisteme nu înțeleg același lucru prin „client”

Într-unul, clientul e firma. În celălalt, persoana de contact. Nu e o problemă tehnică, e una de definiție, și se rezolvă înainte de a scrie cod — altfel se rezolvă de trei ori.

Nimeni nu s-a gândit ce se întâmplă când pică legătura

O integrare bună reia singură ce nu a reușit și anunță pe cineva dacă tot nu merge. Una scrisă în grabă pierde date în tăcere, iar asta se descoperă luni mai târziu.

Se sincronizează tot, tot timpul

Nu ai nevoie de toate datele în ambele sisteme. Stabilește ce trece dintr-o parte în alta și în ce direcție. Mai puțin înseamnă mai puțin de reparat.

Concluzia practică

Nu trebuie să înțelegi cum funcționează un API. Trebuie doar să întrebi dacă există, ce permite și dacă poți vedea documentația. Trei întrebări care îți pot economisi o migrare dureroasă peste câțiva ani.

← Înapoi la blog