Si të filloni me Tregun e Zhvilluesve
Fjalor termash:
- Digital Business: Digital Business është një platformë gjithëpërfshirëse që ofron mjete marketingu, shitjesh dhe automatizimi për të ndihmuar bizneset të rriten dhe të optimizojnë operacionet e tyre.
- Tregu i Zhvilluesve: Tregu i Zhvilluesve është një platformë brenda Digital Business që lejon zhvilluesit të ndërtojnë dhe integrojnë aplikacionet dhe mjetet e tyre duke përdorur API-në e Digital Business.
- API (Ndërfaqja e Programimit të Aplikacioneve): Një API është një grup rregullash dhe protokollesh që lejon aplikacione të ndryshme softuerike të komunikojnë me njëra-tjetrën. Në kontekstin e Tregut të Zhvilluesve, API-ja e Digital Business u mundëson zhvilluesve të kenë akses dhe të ndërveprojnë me veçoritë dhe të dhënat e Digital Business.
- Token Aksesi: Një Token Aksesi është një kredencial që një aplikacion përdor për të hyrë në burime të mbrojtura për një përdorues ose llogari. Në Tregun e Zhvilluesve, zhvilluesit marrin një Token Aksesi përmes procesit OAuth, i cili lejon aplikacionin e tyre të bëjë kërkesa të vërtetuara API drejt Digital Business. Tokeni i Aksesit zakonisht përfshihet në kokën e Autorizimit të kërkesave API.
- AppID - Ky është identifikuesi unik për aplikacionin tuaj në treg. Mund ta gjeni poshtë emrit të aplikacionit.

- ID-ja e Ofruesit të Bisedës - Ky është identifikuesi unik për llojin e ofruesit që një përdorues instalon. Mund ta gjeni nën emrin e ofruesit të bisedës nëse keni krijuar ofrues bisedash për aplikacionin tuaj.

- Token Rifreskimi: Një Token Rifreskimi është një kredencial që mund të përdoret për të marrë një Token të ri Aksesi pa kërkuar që përdoruesi të ri-autorizojë aplikacionin. Ai ofron një mekanizëm autorizimi më afatgjatë dhe ndihmon në ruajtjen e aksesit të vazhdueshëm në burimet e Digital Business. Kur një Token Aksesi skadon, Tokeni i Rifreskimit mund të përdoret për të marrë një të ri.
- OAuth (Autorizimi i Hapur): OAuth është një protokoll standard i industrisë që mundëson autorizim dhe vërtetim të sigurt të aplikacioneve. Ai u lejon përdoruesve të japin leje aplikacioneve për të hyrë në të dhënat e tyre të Digital Business pa ndarë kredencialet e tyre të hyrjes. OAuth përfshin një proces autorizimi ku përdoruesit ridrejtohen te Digital Business për t'u vërtetuar dhe për të dhënë akses aplikacionit.
- URI Ridrejtimi: Një URI Ridrejtimi është URL-ja ku Digital Business do t'i dërgojë përdoruesit pas autorizimit të aksesit të aplikacionit. Gjatë procesit OAuth, përdoruesit ridrejtohen te aplikacioni me një kod autorizimi ose token aksesi të shtuar në URI-në e Ridrejtimit pas dhënies së lejes.
- Kodi i Autorizimit: Në procesin OAuth, një Kod Autorizimi është një kredencial afatshkurtër i marrë pasi një përdorues autorizon me sukses një aplikacion. Aplikacioni e shkëmben këtë kod për një Token Aksesi dhe një Token Rifreskimi.
- Scope-t: Scope-t përcaktojnë lejet specifike dhe të drejtat e aksesit që një aplikacion kërkon për të ndërvepruar me Digital Business. Kur krijojnë një aplikacion, zhvilluesit specifikojnë scope-t e nevojshme që përputhen me funksionalitetet e aplikacionit të tyre. Scope-t mund të përfshijnë leje leximi, shkrimi ose menaxhimi për burime të ndryshme brenda Digital Business.
- Endpoint: Një endpoint është një URL ose URI specifike që përfaqëson një burim ose funksionalitet API. API-ja e Digital Business ekspozon endpoint-e të ndryshme që zhvilluesit mund t'i aksesojnë për të kryer veprime specifike ose për të marrë të dhëna specifike.
- Kërkesa: Një kërkesë është një komunikim i bërë nga një aplikacion drejt API-së së Digital Business. Ajo përfshin metodën HTTP (p.sh., GET, POST), URL-në ose endpoint-in, kokat dhe parametrat ose të dhënat e kërkuara.
- Përgjigja: Një përgjigje është përgjigja e serverit ndaj një kërkese të bërë nga një aplikacion. Ajo përmban të dhënat e kërkuara, një konfirmim të veprimit të kryer dhe një kod statusi të përshtatshëm.
- Kodi i Statusit: Një kod statusi është një numër tre-shifror i kthyer nga serveri për të treguar rezultatin e një kërkese HTTP. Kodet e zakonshme të statusit përfshijnë 200 (OK), 400 (Kërkesë e Gabuar), 401 (I Paautorizuar) dhe 422 (Entitet i Përpunueshëm).
- Lloji i Shpërndarjes: Lloji i Shpërndarjes i referohet mënyrës se si një aplikacion shpërndahet ose vihet në dispozicion të përdoruesve të Digital Business. Mund të jetë ose Agjenci ose Nën-Llogari. Shpërndarja e Agjencisë lejon që aplikacioni të përdoret nga të gjitha vendndodhjet brenda një llogarie agjencie, ndërsa shpërndarja e Nën-Llogarisë kufizon përdorimin në nën-llogari specifike ose vendndodhje individuale.
- ID-ja e Vendndodhjes: ID-ja e Vendndodhjes është një identifikues unik i caktuar për një vendndodhje specifike brenda një llogarie të Digital Business. Përdoret për të diferencuar dhe menaxhuar aksesin në nivel vendndodhjeje.
- ID-ja e Kompanisë: ID-ja e Kompanisë është një identifikues unik i caktuar për një kompani ose llogari të Digital Business. Ndihmon në diferencimin dhe menaxhimin e aksesit në nivel kompanie.
- ID-ja e Hashed e Kompanisë: ID-ja e Hashed e Kompanisë është një identifikues i vjetëruar që dikur lidhej me një kompani ose llogari të Digital Business. Nuk është më në përdorim dhe po hiqet gradualisht.
- Serveri Live: Serveri Live i referohet mjedisit aktual të prodhimit ku aplikacioni ndërvepron me API-në e Digital Business dhe të dhënat reale të përdoruesve. Është serveri ku aplikacioni vendoset dhe është i aksesueshëm nga përdoruesit.
- SDK (Kit i Zhvillimit të Softuerit): Një SDK është një set mjetesh, librarish dhe dokumentacionesh që zhvilluesit përdorin për të ndërtuar aplikacione për një platformë ose framework specifik. Digital Business ofron një SDK që lehtëson integrimin e aplikacioneve të personalizuara me API-në e saj.
- Koka e Autorizimit: Koka e Autorizimit është një kokë HTTP që përfshin kredencialet e vërtetimit në kërkesat API, siç është një Token Aksesi. Zakonisht merr formën "Authorization: Bearer {access_token}".
- Çelësi API: Një Çelës API është një identifikues ose kod unik i ofruar zhvilluesve që jep akses në API. Shërben si një formë vërtetimi kur bëhen kërkesa API.
- URL-ja e Kthimit (Callback): Një URL e Kthimit është vendi ku një aplikacion pret të marrë kthime ose përgjigje. Në kontekstin e Tregut të Zhvilluesve, URL-ja e Kthimit është endpoint-i që merr kodin e autorizimit ose tokenin e aksesit pasi përdoruesi jep leje gjatë procesit OAuth.
- JSON (JavaScript Object Notation): JSON është një format i lehtë për shkëmbimin e të dhënave që është i lehtë për t'u lexuar dhe shkruar nga njerëzit dhe për t'u analizuar dhe gjeneruar nga makinat. Përdoret zakonisht për strukturimin e të dhënave në kërkesat dhe përgjigjet API.
- Parametrat: Parametrat janë vlera shtesë të përfshira në një kërkesë API për të ofruar udhëzime specifike ose për të filtruar të dhënat e dëshiruara. Parametrat mund të përdoren për të specifikuar kritere kërkimi, preferenca renditjeje ose opsione faqosjeje.
- Faqosja: Faqosja është ndarja e një grupi të madh të dhënash në pjesë më të vogla, më të menaxhueshme të quajtura faqe. Përgjigjet API shpesh përfshijnë informacion faqosjeje, si numri i artikujve për faqe dhe numri total i faqeve, duke u lejuar zhvilluesve të marrin të dhënat në mënyrë graduale.
- Kufizimi i Normës: Kufizimi i Normës është një mekanizëm që API-të përdorin për të kufizuar kërkesat e një klienti ose përdoruesi brenda një periudhe të caktuar. Ndihmon në ruajtjen e performancës së API-së dhe parandalimin e abuzimit.
- Webhooks: Webhooks janë kthime ose njoftime HTTP të dërguara nga një aplikacion në tjetrin kur ndodh një ngjarje ose shkas specifik. Në kontekstin e Tregut të Zhvilluesve, zhvilluesit mund të konfigurojnë webhooks për të marrë përditësime në kohë reale ose të dhëna nga Digital Business, siç janë lead-et e reja ose informacionet e kontaktit.
- Ngjarja: Një Ngjarje i referohet një ndodhie ose veprimi specifik brenda një aplikacioni ose sistemi. Në kontekstin e webhooks, ngjarjet janë shkasë që nxisin dërgimin e një njoftimi webhook.
- GET: GET është një metodë HTTP për të marrë të dhëna nga serveri. Përdoret zakonisht për të marrë burime ose informacion nga API-të.
- POST: POST është një metodë HTTP për të dërguar të dhëna në një server. Zakonisht përdoret për të krijuar burime të reja ose për të dërguar të dhëna për t'u përpunuar nga API-të.
- PUT: PUT është një metodë HTTP për të përditësuar ose zëvendësuar të dhëna ekzistuese në një server. Ajo zëvendëson të gjithë burimin me të dhënat e reja të ofruara në kërkesë.
- DELETE: DELETE është një metodë HTTP që heq ose fshin një burim nga një server. Udhëzon serverin të fshijë burimin e specifikuar.
- Zhvillimi Front-End: Zhvillimi Front-End përfshin ndërtimin e komponentëve të një aplikacioni softuerik që janë të dukshëm për përdoruesin. Zakonisht përfshin zhvilluesit që përdorin HTML, CSS dhe JavaScript për të krijuar ndërfaqe interaktive dhe vizualisht tërheqëse.
- Zhvillimi Back-End: Zhvillimi Back-End fokusohet në komponentët anësorë të serverit të një aplikacioni softuerik. Përfshin implementimin e logjikës, ruajtjen e të dhënave dhe përpunimin e nevojshëm për të mbështetur funksionalitetin e aplikacionit.
Çfarë është Rrjedha e OAuth në Tregun e Zhvilluesve?
Rrjedha e OAuth në Tregun e Zhvilluesve zakonisht përbëhet nga hapat e mëposhtëm:
Regjistrimi i Aplikacionit: Zhvilluesit regjistrojnë aplikacionet e tyre në Tregun e Zhvilluesve, duke ofruar detajet e nevojshme dhe duke përcaktuar scope-t. Ata marrin një ID Klienti dhe një Sekret Klienti, identifikues unikë për aplikacionin e tyre.
Kërkesa për Autorizim: Aplikacioni e drejton përdoruesin (zakonisht përmes një shfletuesi) te serveri i autorizimit të Tregut. Kërkesa për autorizim përfshin ID-në e Klientit, scope-t e kërkuara dhe një URL ridrejtimi, një vendndodhje në aplikacion ku përdoruesit do të dërgohen pas autorizimit.
Pëlqimi i Përdoruesit: Përdoruesi hyn në Treg dhe shqyrton kërkesën e aplikacionit për të hyrë në detaje specifike (siç përcaktohen nga scope-t). Nëse përdoruesi pajtohet, ata ridrejtohen te URL-ja e ridrejtimit të ofruar, me një kod autorizimi të shtuar si një parametër kërkese.
Dhënia e Autorizimit: Aplikacioni merr kodin e autorizimit dhe e verifikon atë. Aplikacioni më pas bën një kërkesë POST te serveri i autorizimit, duke përfshirë kodin e autorizimit, ID-në e Klientit dhe Sekretin e Klientit.
Lëshimi i Tokenit të Aksesit: Nëse të gjitha detajet e paraqitura janë të sakta dhe kodi i autorizimit është i vlefshëm, serveri i autorizimit lëshon një token aksesi për aplikacionin. Aplikacioni tani mund ta përdorë këtë token aksesi për të bërë kërkesa në API në emër të përdoruesit, të kufizuara në scope-t e përcaktuara më herët.
Thirrja API: Aplikacioni përfshin tokenin e aksesit në kokë kur bën thirrje API. Serveri lejon operacionin e kërkuar nëse tokeni i aksesit është i vlefshëm dhe ka scope-t e nevojshme.
Rifreskimi i Tokenit: Tokenët e aksesit kanë një jetëgjatësi të kufizuar dhe duhet të rifreskohen periodikisht duke përdorur një token rifreskimi (nëse ofrohet nga serveri i autorizimit). Aplikacioni i kërkon serverit me tokenin e rifreskimit; një token i ri aksesi lëshohet nëse është i vlefshëm.
Mbani mend, OAuth është një protokoll delegimi, i dobishëm në skenarë ku aplikacioni duhet të veprojë në emër të përdoruesve pa kërkuar kredencialet e përdoruesve. Rrjedha aktuale mund të ndryshojë pak bazuar në implementimin e Tregut, por parimet themelore mbeten të njëjta.
OAuth 2.0 me PKCE (Proof Key for Code Exchange)
Tregu i Digital Business mbështet gjithashtu OAuth 2.0 me PKCE për vërtetim të jashtëm. Aktivizoni PKCE kur integrimi juaj përdor një klient publik (për shembull, aplikacione të bazuara në shfletues ose celularë) ose kur ofruesi juaj OAuth kërkon PKCE.
Kur PKCE është aktivizuar, kërkesa për autorizim përfshin një `code_challenge` dhe `code_challenge_method` (`S256`), dhe kërkesa për token përfshin `code_verifier`-in përkatës.
Raste Përdorimi:
- Menaxhimi i Kontakteve: Përdorni API-të e menaxhimit të kontakteve për të krijuar, përditësuar, kërkuar dhe fshirë kontakte, duke mundësuar menaxhim efikas të marrëdhënieve me klientët.
- Menaxhimi i Bisedave: Implementoni API-në e Bisedave për të marrë, përditësuar dhe fshirë biseda, duke lejuar komunikim të optimizuar me klientët.
- Automatizimi i Mesazheve: Përdorni API-të e mesazheve për të dërguar dhe planifikuar mesazhe të automatizuara email dhe SMS, duke rritur angazhimin e klientëve dhe ushqyerjen e lead-eve.
- Dorëzimet e Formularëve: Implementoni API-të e formularëve për të kapur dhe menaxhuar dorëzimet e formularëve, duke mundësuar gjenerimin e lead-eve dhe mbledhjen e të dhënave.
- Menaxhimi i Lidhjeve: Përdorni API-në e lidhjeve për të krijuar, përditësuar dhe fshirë lidhje, duke lejuar ndjekje dhe menaxhim efektiv të lidhjeve URL.
- Etiketimi i Vendndodhjeve: Përdorni API-të e etiketave të vendndodhjeve për të caktuar dhe menaxhuar etiketa për vendndodhje të ndryshme, duke lehtësuar kategorizimin dhe filtrimin e organizuar.
- Menaxhimi i Fushave të Personalizuara: Implementoni API-të e fushave të personalizuara për të krijuar, përditësuar dhe fshirë fusha të personalizuara, duke mundësuar organizim fleksibël dhe personalizim të të dhënave.
- Menaxhimi i Vlerave të Personalizuara: Përdorni API-të e vlerave të personalizuara për të krijuar, përditësuar dhe fshirë vlera të personalizuara të lidhura me kontaktet, duke rritur personalizimin e të dhënave.
- Menaxhimi i Modeleve: Përdorni API-të e modeleve të email-it dhe SMS-ve për të krijuar, marrë dhe përditësuar modele, duke lehtësuar mesazhe të qëndrueshme dhe efikase.
- Menaxhimi i Mundësive: Përdorni API-të e mundësive për të krijuar, përditësuar dhe fshirë mundësi, duke mundësuar menaxhim efektiv të tubacionit të shitjeve.
- Krijimi i Shënimeve: Implementoni API-në e krijimit të shënimeve për të shtuar shënime në profilet e klientëve, duke lehtësuar dokumentimin e lehtë dhe ndarjen e informacionit.
- Menaxhimi i Detyrave: Përdorni API-të e detyrave për të krijuar, përditësuar dhe fshirë detyra, duke mundësuar ndjekje efikase të detyrave dhe menaxhim të rrjedhës së punës.
- Planifikimi i Takimeve: Përdorni API-të e takimeve për të krijuar dhe përditësuar takime, duke lehtësuar planifikimin e lehtë dhe menaxhimin e kalendarit.
- Përpunimi i Porosive: Përdorni API-të e porosive për të krijuar, përditësuar dhe menaxhuar porositë e klientëve, duke optimizuar procesin e përmbushjes së porosive.
- Menaxhimi i Klientëve: Implementoni API-të e klientëve për të krijuar, përditësuar dhe fshirë profilet e klientëve, duke lehtësuar menaxhimin gjithëpërfshirës të marrëdhënieve me klientët.
- Menaxhimi i Përdoruesve: Përdorni API-të e përdoruesve për të krijuar, përditësuar dhe fshirë llogaritë e përdoruesve, duke lehtësuar administrimin e përdoruesve dhe kontrollin e aksesit.
- Automatizimi i Rrjedhës së Punës: Përdorni API-të e rrjedhës së punës për të krijuar, përditësuar dhe fshirë rrjedhat e punës, duke mundësuar procese biznesi të automatizuara dhe automatizim të detyrave.
- Marrja e Pamjeve të Çastit: Përdorni API-të e pamjeve të çastit për të marrë dhe menaxhuar pamje të çastit të të dhënave, duke lejuar analizën historike të të dhënave dhe raportimin.
Këto raste përdorimi demonstrojnë se si API-të e tregut të zhvilluesve mund të zbatohen në skenarë të ndryshëm praktikë për të rritur produktivitetin, për të automatizuar proceset dhe për të optimizuar operacionet e biznesit.
Si të përdorni oAuth V2 për të konfiguruar Webhooks për aplikacionet tuaja?
Për të konfiguruar webhooks për aplikacionin tuaj, ndiqni këto hapa:
Hapi 1: Regjistrohuni për një llogari zhvilluesi
Shkoni në tregun e zhvilluesve dhe regjistrohuni për një llogari zhvilluesi nëse nuk e keni bërë tashmë.
Hapi 2: Krijoni një aplikacion
Pasi të hyni, shkoni te "Aplikacionet e Mia" dhe klikoni "Krijo Aplikacion" për të krijuar një aplikacion të ri.

Hapi 3: Plotësoni informacionin e profilit
Plotësoni të gjithë informacionin e kërkuar të profilit për aplikacionin tuaj.
Sigurohuni që ta shënoni aplikacionin si publik.

Emri i Aplikacionit:
"Emri i Aplikacionit" i referohet emrit ose titullit të dhënë aplikacionit tuaj. Është një identifikues unik që përfaqëson aplikacionin tuaj brenda tregut të zhvilluesve dhe ndihmon përdoruesit ta identifikojnë dhe dallojnë shpejt atë nga aplikacionet e tjera.
Lloji i Aplikacionit: Publik, Privat:
"Lloji i Aplikacionit" përcakton aksesueshmërinë dhe dukshmërinë e aplikacionit tuaj.
Aplikacion Publik: Një aplikacion publik është i disponueshëm për këdo për t'u përdorur dhe aksesuar. Ai listohet në tregun e zhvilluesve dhe mund të instalohet nga përdoruesit me lejet e nevojshme.
Aplikacion Privat: Një aplikacion privat është i kufizuar për një grup ose individë specifikë. Ai nuk listohet publikisht në Treg dhe kërkon një ftesë ose autorizim për t'u aksesuar dhe përdorur.
Lloji i Shpërndarjes: Agjenci, Nën-Llogari:
"Lloji i Shpërndarjes" specifikon se si aplikacioni juaj shpërndahet dhe vihet në dispozicion të përdoruesve.
Shpërndarja e Agjencisë: Nëse zgjidhni llojin e shpërndarjes së agjencisë, aplikacioni juaj do të jetë i aksesueshëm për të gjitha llogaritë. Kjo do të thotë që të gjithë anëtarët e agjencisë ose nën-llogaritë mund ta instalojnë dhe përdorin aplikacionin. Të gjitha
Shpërndarja e Nën-Llogarisë: Me llojin e shpërndarjes së nën-llogarisë, aplikacioni juaj është i kufizuar në një nën-llogari specifike brenda agjencisë tuaj. Vetëm përdoruesit që i përkasin asaj nën-llogarie të veçantë mund ta instalojnë dhe përdorin aplikacionin.
Hapi 4: Shtoni scope-t
Në cilësimet e aplikacionit, shtoni scope-t e kërkuara për aplikacionin tuaj.
Referojuni dokumentacionit për të përcaktuar scope-t e nevojshme.

Hapi 5: Gjeneroni kredencialet e klientit
Krijoni një çelës klienti për aplikacionin tuaj.
Ruani ID-në e Klientit dhe Sekretin e Klientit të gjeneruar, siç nevojitet, në hapat e ardhshëm.


Hapi 6: Konfiguroni endpoint-in OAuth
Krijoni një endpoint GET në aplikacionin tuaj që do të trajtojë procesin OAuth.
Referojuni dokumentacionit për më shumë detaje se si të merrni tokenin e aksesit.
Për të krijuar një endpoint GET për OAuth në aplikacionin tuaj:
- Zgjidhni një rrugë për endpoint-in tuaj (p.sh., "/OAuth/callback/digitalbusiness").
- Konfiguroni aplikacionin tuaj për të dëgjuar kërkesat në këtë rrugë.
- Kur një përdorues autorizon aplikacionin tuaj, Digital Business do t'i ridrejtojë ata te endpoint-i juaj me një parametër "code".
- Merrni parametrin "code" nga kërkesa.
- Ruajeni kodin në mënyrë të sigurt.
- Bëni një kërkesë POST te endpoint-i "/OAuth/token" i Digital Business me kodin, ID-në e klientit, sekretin e klientit, llojin e grantit dhe URI-në e ridrejtimit.
- Kapni përgjigjen nga kërkesa POST.
- Nxirrni tokenin e aksesit, llojin e tokenit, kohën e skadimit, tokenin e rifreskimit dhe informacione të tjera të rëndësishme nga përgjigja.
- Ruajeni tokenin e aksesit në mënyrë të sigurt në aplikacionin tuaj.
Tani mund ta përdorni tokenin e aksesit për të vërtetuar kërkesat API të Digital Business.
Duke ndjekur këto hapa, endpoint-i juaj GET do të trajtojë procesin OAuth duke shkëmbyer kodin për një token aksesi dhe duke e ruajtur atë në mënyrë të sigurt për ndërveprime të ardhshme API.
Hapi 7: Konfiguroni cilësimet e OAuth
Vendosni URL-në e Ridrejtimit të OAuthToken në cilësimet e aplikacionit tuaj te endpoint-i i krijuar në hapin e mëparshëm.

Hapi 8: Krijoni një endpoint webhook
Krijoni një endpoint POST në aplikacionin tuaj për të marrë dhe përpunuar ngjarjet webhook.
Ky endpoint duhet të jetë në gjendje të trajtojë trupin JSON të ngjarjes.
Hapi 9: Konfiguroni URL-në e webhook
Futni URL-në e endpoint-it tuaj webhook në cilësimet e aplikacionit.
Hapi 10: Caktoni vendndodhje/llogari në aplikacionin tuaj
Hyni në një llogari administratori agjencie.
Hapni një skedë të re shfletuesi dhe shkoni te aplikacioni juaj në Treg.
Klikoni "+ Shto Aplikacion" dhe kërkoni/zgjidhni llogarinë/vendndodhjen e dëshiruar për të shtuar webhook-un.
Hapi 11: Merrni kodin e autorizimit
Pasi të keni shtuar me sukses aplikacionin, do të ridrejtoheni në faqen e Aplikacionit të Tregut me një URL të përditësuar.
Kopjoni parametrin e vargut të kërkesës "code" nga URL-ja (p.sh., code=c40216d8574eb90abe0c884058fa9f5101085exx).
Hapi 12: Hapni një skedë të re shfletuesi
Hapni një skedë të re shfletuesi dhe futni URL-në e mëposhtme: URL_JUAJ_RIDREJTIMI?code=KODI
Zëvendësoni URL_JUAJ_RIDREJTIMI me URL-në e ridrejtimit të aplikacionit tuaj dhe KODI me kodin e autorizimit të kopjuar në hapin e mëparshëm.
Hapi 13: Verifikoni lidhjen e webhook
Nëse përgjigja nga endpointi i tokenit ishte e suksesshme dhe keni marrë tokenin e aksesit, webhooks duhet të jenë tani të lidhur.
Duke ndjekur këto hapa, duhet të jeni në gjendje të konfiguroni webhooks për aplikacionin tuaj dhe t'i lidhni ato me llogaritë/vendndodhjet e dëshiruara. Referojuni dokumentacionit të ofruar për informacion të detajuar mbi çdo hap.
Pyetje të Shpeshta
P: Çfarë është Tregu i Zhvilluesve?
P: Tregu i Zhvilluesve është një platformë e ofruar nga Digital Business ku zhvilluesit mund të krijojnë dhe shpërndajnë aplikacionet dhe integrimet e tyre të personalizuara për t'u përdorur me CRM-në e Digital Business.
P: Si mund të regjistrohem për një llogari zhvilluesi në Treg?
P: Për t'u regjistruar për një llogari zhvilluesi në Treg, shkoni në faqen e internetit dhe klikoni butonin e regjistrimit. Ndiqni udhëzimet për të krijuar llogarinë tuaj.
P: Çfarë janë scope-t në kontekstin e cilësimeve të aplikacionit?
P: Scope-t përcaktojnë lejet dhe nivelet e aksesit që aplikacioni juaj kërkon për të ndërvepruar me CRM-në e Digital Business. Ju duhet të shtoni scope-t e duhura në cilësimet e aplikacionit tuaj bazuar në funksionalitetet që i nevojiten aplikacionit tuaj.
P: Si mund të gjeneroj kredencialet e klientit për aplikacionin tim?
P: Në cilësimet e aplikacionit, ka një opsion për të gjeneruar kredencialet e klientit. Klikoni mbi të dhe do të merrni një ID Klienti dhe një Sekret Klienti që mund t'i përdorni për qëllime vërtetimi dhe autorizimi.
P: Mund të shpjegoni procesin e OAuth me një aplikacion të personalizuar?
P: OAuth është një protokoll për autorizim të sigurt midis aplikacionit tuaj të personalizuar dhe CRM-së së Digital Business. Ju duhet të krijoni një endpoint GET në aplikacionin tuaj për të trajtuar procesin OAuth. Ky endpoint do të marrë një parametër kodi, të cilin do ta përdorni për të kërkuar një token aksesi nga API-ja e Digital Business.
P: Cili është qëllimi i URL-së së Ridrejtimit të OAuthToken?
P: URL-ja e Ridrejtimit të OAuthToken është endpoint-i në aplikacionin tuaj ku do të dërgohet tokeni i aksesit pasi procesi OAuth të përfundojë me sukses. Duhet të përcaktohet në cilësimet e aplikacionit tuaj.
P: Si mund të krijoj një endpoint webhook për aplikacionin tim?
P: Për të krijuar një endpoint webhook, ju duhet të konfiguroni një endpoint POST në aplikacionin tuaj për të marrë dhe përpunuar ngarkesat JSON të dërguara nga CRM-ja e Digital Business. Ky endpoint do të trajtojë ngjarjet webhook dhe do të shkaktojë veprimet e nevojshme në aplikacionin tuaj.
P: Si mund t'i caktoj vendndodhje/llogari aplikacionit tim në treg?
P: Ju mund t'i caktoni vendndodhje/llogari aplikacionit tuaj në treg si administrator agjencie. Hapni aplikacionin në Treg, klikoni mbi "+ Shto Aplikacion", kërkoni llogarinë/vendndodhjen e dëshiruar dhe zgjidheni atë për të vendosur lidhjen webhook.
P: Cili është qëllimi i kodit të autorizimit në procesin e lidhjes së webhook?
P: Kodi i autorizimit është një kod unik i gjeneruar gjatë procesit të lidhjes së webhook. Është një token autorizimi i përkohshëm që shkëmbehet për një token aksesi, duke i lejuar aplikacionit tuaj të ndërveprojë me API-në e Digital Business në mënyrë të sigurt.
P: Si mund ta verifikoj lidhjen e webhook?
P: Pasi të keni përfunduar procesin e lidhjes së webhook dhe të keni marrë tokenin e aksesit, mund ta verifikoni lidhjen duke testuar endpoint-in tuaj webhook. Shkaktoni një ngjarje testimi në CRM-në e Digital Business dhe kontrolloni nëse endpoint-i juaj e merr dhe e përpunon ngjarjen saktë.
P: A mund të krijoj shumë aplikacione në Tregun e Zhvilluesve?
P: Po, ju mund të krijoni shumë aplikacione në Tregun e Zhvilluesve. Çdo aplikacion mund të ketë profilin, cilësimet dhe konfigurimet e veta webhook.
P: A ka një kufi për numrin e scope-ve që mund t'i shtoj aplikacionit tim?
P: Nuk ka një kufi specifik për numrin e scope-ve që mund t'i shtoni aplikacionit tuaj. Megjithatë, rekomandohet të përfshini vetëm scope-t e nevojshme që kërkon aplikacioni juaj për të minimizuar lejet e panevojshme dhe për të përmirësuar sigurinë.
P: Sa shpesh duhet ta përditësoj informacionin e profilit të aplikacionit tim?
P: Është një praktikë e mirë ta mbani të përditësuar informacionin e profilit të aplikacionit tuaj. Nëse ka ndryshime të rëndësishme në aplikacionin tuaj, si veçori të reja ose përmirësime, përditësoni profilin për të ofruar informacion të saktë për përdoruesit e mundshëm.
P: A mund të aksesoj të dhënat e përdoruesve përmes Tregut të Zhvilluesve?
P: Ju mund të aksesoni të dhënat e përdoruesve përmes Tregut të Zhvilluesve duke përdorur scope-t dhe API-të e duhura të ofruara nga CRM-ja e Digital Business. Megjithatë, është thelbësore të trajtoni të dhënat e përdoruesve me përgjegjësi dhe të respektoni rregulloret përkatëse të mbrojtjes së të dhënave.
P: A mund të integroj shërbime të palëve të treta me aplikacionin tim në Tregun e Zhvilluesve?
P: Po, ju mund të integroni shërbime të palëve të treta me aplikacionin tuaj në Tregun e Zhvilluesve. Për sa kohë që integrimi i përmbahet udhëzimeve të platformës dhe API-të ose webhooks të nevojshme janë të disponueshme, ju mund të përmirësoni funksionalitetin e aplikacionit tuaj duke e lidhur atë me shërbime të jashtme.
