Si të përdorni API-në publike të systeme.io (Ndërfaqja e Programimit të Aplikacioneve)
Në këtë artikull, do të mësoni se si të konfiguroni dhe përdorni API-në publike të systeme.io, duke përfshirë si të gjeneroni çelësa API dhe cilat veprime mund të kryeni.
1. Çfarë është një API?
Shkurtesa API qëndron për "Ndërfaqja e Programimit të Aplikacioneve", një seri instruksionesh me të cilat një platformë ofron shërbime për platforma të tjera. Është një portë strategjike për zhvilluesit e jashtëm, duke u mundësuar atyre të aksesojnë funksionalitete specifike ose të dhëna nga një platformë në mënyrë të strukturuar dhe të sigurt. Është si një set mjetesh të gatshme për t'u përdorur që e bëjnë të lehtë krijimin e aplikacioneve të reja, shërbimeve ose kombinacioneve.
Me pak fjalë, systeme.io hapet ndaj platformave të tjera për të ofruar shërbimet e tij aty ku ka vlerë të shtuar.
2. Si funksionon API-ja jonë publike?
API-ja jonë ekspozon një set veçorish të zgjedhura me kujdes, duke mundësuar që zhvilluesit të ndërveprojnë me platformën tonë në mënyrë transparente dhe efikase. Nëse dëshironi të dini më shumë rreth funksionimit të saj, mund të lexoni dokumentacionin tonë zyrtar të API-së.
3. Si të krijoni çelësat tuaj API
Çelësat API janë identifikues unikë që autentifikojnë kërkesat drejt API-së sonë Publike. Ato ju mundësojnë të aksesoni dhe menaxhoni në mënyrë programatike burime të ndryshme në platformën tonë.
Për të krijuar një çelës publik API, klikoni mbi fotografinë tuaj të profilit, zgjidhni Cilësimet (1) dhe lëvizni poshtë te Çelësat MCP & API (2).

Klikoni Krijo (3) për të filluar krijimin e një çelësi publik API.

Në dritaren popup Krijo çelës publik API, vendosni një emër dhe zgjidhni një datë dhe orë skadimi për çelësin tuaj API.
Pasi të keni përfunduar, klikoni Ruaj (4).

Shënim: Për ta mbajtur çelësin tuaj API aktiv për një kohë të pacaktuar, lini bosh fushën “Skadimi”.
Çelësi juaj është tani gati.

4. Çfarë mund të bëni me API-në tonë?
API-ja jonë hap disa mundësi interesante. Më poshtë do të gjeni veprimet kryesore që mund të kryeni duke përdorur API-në tonë publike:
a. Kontaktet, etiketat dhe fushat e personalizuara:
- Menaxhoni kontaktet: Krijoni kontakte të reja, përditësoni ato ekzistuese, listoni audiencën tuaj me filtra të avancuar, ose fshini kontaktet.
- Menaxhoni etiketat: Krijoni, caktoni, listoni dhe largoni etiketat nga kontaktet.
- Fusha të personalizuara: Merrni fushat e personalizuara të kontaktit dhe identifikuesit e tyre (slug) për të plotësuar saktë informacionin e kontaktit.
b. Buletinet:
- Krijoni dhe përditësoni buletinet: Krijoni draft-e të reja buletinesh ose përditësoni pjesërisht ato ekzistuese. Ju mund të përcaktoni llojin e editorit (Klasik ose Vizual), të merrni përmbajtjen e plotë HTML dhe të përcaktoni emrin e dërguesit dhe adresën e emailit.
- Listoni dhe merrni: Shfletoni buletinet ekzistuese ose merrni përmbajtjen e plotë të një buletini të veçantë duke përdorur ID-në e tij.
c. Tonelatat dhe redaktori i faqeve:
- Menaxhoni tonelatat: Krijoni tonelata të reja, shtoni hapa të rinj (faqet) në to, dhe merrni një listë të të gjitha hapave individualë brenda një tonë të veçantë.
- Redaktori i faqeve: Ruani përmbajtjen e gjeneruar të faqes drejtpërdrejt në hapat e tonelatës ose faqet e internetit (zëvendësim i plotë), dhe merrni skema JSON për lloje të caktuara faqesh.
d. Planet e çmimeve dhe kuponat:
- Krijo, edito dhe fshi: Gjeneroni plane çmimesh dhe kupona të rinj, ose përditësoni dhe fshini pjesërisht ato ekzistuese.
- Listoni dhe kërkoni: Shfletoni të gjitha planet ekzistuese të çmimeve dhe kuponave, ose merrni sende specifike sipas ID-së së tyre.
e. Kurset dhe studentët:
- Menaxhoni kurset dhe studentët: Merrni një listë të kurseve tuaja ekzistuese dhe merrni një listë të studentëve aktualisht të regjistruar.
- Regjistro studentët: Regjistroni në mënyrë programatike kontaktet tuaja në kurset individuale.
Shënim për kurset: Mbështetja për pako kursesh do të shtohet në përditësimet e ardhshme.
f. Komunitetet:
- Menaxhoni komunitetet: Merrni një listë të komuniteteve tuaja ekzistuese dhe aksesoni një listë të anëtarëve aktualë brenda një komuniteti të veçantë.
- Ftoni anëtarët: Ftoni në mënyrë programatike përdoruesit e rinj të bashkohen në komunitetet tuaja duke ofruar ID-në e kontaktit të tyre.
g. Rregullat e automatizimit:
- Menaxhoni rregullat: Lidheni në mënyrë programatike ngjarjet e zakonshme dhe veprimet, përditësoni rregullat ekzistuese (p.sh., duke ndryshuar një veprim ndërkohë që ruani të njëjtin nxitës), ose fshini lehtë rregullat.
- Listoni dhe merrni: Shfletoni rregullat tuaja të automatizimit ose merrni një rregull të veçantë sipas ID-së.
h. Abonimet:
- Menaxhoni abonimet: Merrni një listë të të gjitha burimeve në një abonim nga platformat e palëve të treta, dhe anuloni një abonim ose menjëherë ose në fund të ciklit të faturimit.
i. Webhook-et
- Menaxhoni webhook-et: Krijoni në mënyrë programatike webhook-e të reja për të marrë njoftime në kohë reale, merrni lista të webhook-eve tuaja ekzistuese, dhe largoni webhook që nuk nevojiten më.
Shënime:
- Për të identifikuar dhe menaxhuar lehtësisht token-et tuaj, secili duhet të ketë një emër unik.
- Një token mund të kopjohet vetëm menjëherë pas krijimit të tij. Nëse harroni të kopjoni token-in tuaj, fshijeni atë dhe krijoni një të ri.
- Si masë sigurie, ne do t'ju dërgojmë një njoftim me email sa herë që krijohet një çelës i ri publik API në llogarinë tuaj systeme.io.
- Ju mund të krijoni deri në 3 çelësa API për çdo llogari.
Mësoni më shumë: Dokumentacioni i API-së.