Podešavanja Za programere su mesto gde povezujete Exayard sa svojim sopstvenim kodom i sa aplikacijama koje prave druge kompanije. Otvorite Podešavanja, a zatim Za programere. Samo administratori kompanije vide ovu stavku u meniju Podešavanja. Član koji otvori stranicu može da je čita, ali ne može ništa da promeni.

Aplikacije, API ključevi, webhookovi i evidencija dolaze uz svaki plan, uključujući i Free. Naplaćuje se samo AI rad.

Aplikacija je jedna od vaših integracija, poput „Acme estimator” ili „Noćna sinhronizacija”. Svaki API ključ pripada nekoj aplikaciji. Aplikacije su prvi odeljak na stranici. Svaki član može da ga čita. Samo administratori prave ili menjaju aplikacije.

Kliknite na Nova aplikacija i popunite polja Naziv, Opis, Početna stranica, E-pošta za podršku i Opsezi. Opsezi prate podelu na čitanje i pisanje po resursu, poput read:projects i write:estimates. Aplikacije ne mogu da traže opseg admin:org. Kompanija može da ima do 25 aplikacija.

Svaka aplikacija prikazuje kada je kreirana i svoje ograničenje broja zahteva, poput „Do 60 zahteva u minuti po kompaniji i 600 ukupno”. Meni Još radnji aplikacije sadrži:

API ključ omogućava vašem sopstvenom kodu da poziva Exayard API. Ključevi se nalaze unutar aplikacije, u odeljku Ključevi. Ključ radi u sopstvenoj kompaniji svoje aplikacije, tako da nema ID-a kompanije za prosleđivanje.

Da biste ga napravili, kliknite na Novi ključ u aplikaciji. Dajte ključu Naziv, poput „Produkcija”. U polju Opsezi izaberite Svi za svaki opseg koji aplikacija ima ili Određeni da izaberete manje njih. Postavite opcioni datum u polju Ističe ako je ključ namenjen kratkotrajnom radu. Ključ radi do kraja tog dana. Kliknite na Kreiraj.

Exayard prikazuje ceo ključ jednom. Tada ga kopirajte, jer se nikada više ne prikazuje. Exayard čuva samo šifrovanu kopiju, tako da se izgubljeni ključ ne može povratiti. Napravite novi i opozovite stari.

Ključ počinje sa exa_live_. Ključ napravljen u sandboxu počinje sa exa_test_. Nakon što ga kreirate, ključ prikazuje svoj naziv, pregled poput exa_live_...AbCd i Poslednje korišćenje ili Nikad korišćen. Ključ sa rokom važenja prikazuje Ističe i svoj datum, a istekli ključ prikazuje Istekao.

Aplikacija može da ima do 25 aktivnih ključeva. Istekli ključ se i dalje računa dok ga ne opozovete. Da biste zamenili ključeve bez prekida, napravite drugi ključ, prebacite svoje servere na njega, a zatim opozovite prvi.

Otvorite meni Radnje za ključ da ga preimenujete (Preimenuj) ili opozovete (Opozovi). Opozivanje se ne može poništiti i ključ prestaje da radi u roku od 30 sekundi.

Ako se ključ pojavi na javnom mestu, na primer u javnom repozitorijumu koda, Exayard ga opoziva, šalje e-poruku vašim administratorima i zadržava ga na listi sa oznakom Javno otkriven, opozvan.

Kada je druga kompanija instalirala vašu aplikaciju, dijalog za novi ključ prikazuje i polje Radi u. Ova kompanija je podrazumevani izbor. Svaka kompanija koja ju je instalirala pravi ključ koji vaš server koristi u svakoj od tih kompanija. Svaki poziv tada navodi svoju kompaniju u zaglavlju Exayard-Organization-Id.

Isti ključevi povezuju alate bez koda. Pogledajte Povezivanje Exayard-a sa Zapier-om, Povezivanje Exayard-a sa Make-om i Povezivanje Exayard-a sa n8n-om. Za AI asistente, pogledajte Povezivanje Exa sa vašim AI asistentom.

Ključevi napravljeni pre nego što su ključevi smešteni u aplikacije počinju sa ak_. Oni i dalje rade, ali se novi ne mogu praviti. Pojavljuju se u odeljku Stari ključevi na dnu stranice, samo dok ih ima.

Svaki administrator tamo vidi svaki ključ kompanije, bez obzira na to ko ga je napravio. Ključ koji je napravio neko drugi prikazuje Napravio i ime te osobe. Svaka osoba vidi i svoje lične ključeve. Kliknite na ikonu korpe za otpatke da opozovete ključ (Opozovi). On odmah prestaje da radi.

Sandbox je probna kompanija povezana sa vašom. Koristite ga da napravite i testirate integraciju bez diranja vaših pravih projekata. Samo administratori vide Sandboxi.

Kliknite na Novi sandbox, dajte mu Naziv i kliknite na Kreiraj. Kompanija može da ima do 5 sandboxa. Otvori vas prebacuje u sandbox, gde ga birač kompanija označava kao Sandbox. Tamo napravite aplikaciju i ključ kao i obično. Njegovi ključevi počinju sa exa_test_. Da biste prešli na stvarni rad, napravite istu aplikaciju i ključ u svojoj pravoj kompaniji i zamenite ključ u svom kodu.

Sandbox prati plan vaše kompanije, a vaša kompanija plaća njegovu potrošnju. Nema sopstveni obračun i ne dobija sopstvenu mesečnu AI potrošnju. Webhookovi i integracije rade kao i u vašoj pravoj kompaniji.

Sandbox ne šalje e-poruke za deljenje ponuda niti potpisane primerke ljudima izvan njega, i ne šalje SMS poruke. One se prikazuju kao „Nije poslato jer je ova kompanija sandbox”. Pozivnice za pridruživanje sandboxu šalju se kao i obično.

Predmeri i čitanje datoteka u sandboxu vraćaju rezultate kopirane iz našeg primera projekta, bez troška. Predmer, njegove stranice i webhook o završetku predmera označeni su kao primeri. Predračuni, ponude, pretraga elemenata i čet takođe odgovaraju primerima, bez troška.

Da biste uklonili sandbox, kliknite na Izbriši u njegovom redu, a zatim na Izbriši sandbox. Sandbox se zatvara, njegovi ključevi prestaju da rade, a njegovi podaci se kasnije brišu.

Webhook govori Exayard-u da obavesti vaš server kada se nešto desi u vašoj kompaniji. Svaki član može da čita listu. Samo administratori dodaju ili menjaju webhookove.

Kliknite na Kreiraj webhook, unesite URL koji treba da prima isporuke i dodajte opcioni Opis. Izaberite koje Događaji da se šalju. Izaberite Svi da primate svaki događaj, uključujući i nove, ili Određeni da birate sa liste. Svaki događaj i njegov sadržaj navedeni su u katalogu webhook događaja.

Kada kreirate webhook, Exayard jednom prikazuje njegov Tajni ključ za potpisivanje. Tada ga kopirajte, jer se ne prikazuje ponovo.

Otvorite meni Još radnji webhooka za ostalo:

Probni događaj i ponovno slanje šalju se jednom i nikada se ne ponavljaju.

Svaka isporuka nosi zaglavlje Exayard-Signature u obliku t=<unix>,v1=<digest>. Exayard gradi potpis spajanjem vremenske oznake i tela zahteva, a zatim ih potpisuje pomoću HMAC-SHA256 koristeći tajni ključ vašeg webhooka.

Svaka isporuka nosi i zaglavlja Exayard-Event-Id, Exayard-Event-Type i Exayard-Organization-Id. JSON telo ima polje organizationId koje navodi kompaniju iz koje događaj potiče. Zaglavlje nosi isti ID, tako da isporuku možete usmeriti pre nego što pročitate telo. Potpis obuhvata celo telo, uključujući i organizationId.

Pošto svaka isporuka navodi svoju kompaniju, jedna adresa prijemnika može da opslužuje više kompanija. Registrujte isti URL u svakoj kompaniji i usmeravajte svaku isporuku prema organizationId. Svaki webhook ima sopstveni tajni ključ, zato izaberite tajni ključ prema Exayard-Organization-Id pre verifikacije.

Da biste verifikovali isporuku, ponovo izračunajte potpis pomoću svog tajnog ključa, potvrdite da je vremenska oznaka u okviru pet minuta od sada i uporedite sažetke.

Neuspela isporuka se pokušava do 10 puta ukupno, tokom otprilike 80 sati, sa sve dužim čekanjem između pokušaja. Svaki pokušaj šalje isto telo i isti ID događaja. Preusmeravanje se računa kao neuspeh.

Vaša aplikacija radi u vašoj kompaniji čim je napravite. Svaka aplikacija ima i deo Dozvoli drugim kompanijama da instaliraju ovu aplikaciju. On prikazuje da li je aplikacija Pregledano, Pregled je zatražen ili Nije pregledano, njene Adrese za prijavu, njen ID klijenta i koliko kompanija može da je instalira.

Administratori otvaraju meni Radnje instalacije za sledeće:

Nova aplikacija može da se instalira u do 25 kompanija pored vaše i ne pojavljuje se u odeljku Pronađi aplikacije. Kompanije iz odeljka Nalozi za vaše klijente ne računaju se u to ograničenje. Kada bude odobrena, aplikacija prikazuje Pregledano i ograničenje instalacija se ukida. Koristite Prikaži u „Pronađi aplikacije” da je navedete u direktorijumu svake kompanije, ili Sakrij iz „Pronađi aplikacije” da je uklonite odatle. Aplikacija sa statusom Suspendovano ne može da poziva Exayard dok podrška ne ukine suspenziju, a njene instalacije se zadržavaju.

Kada uklonite opsege iz aplikacije, sve instalacije ih odmah gube. Kada dodate opsege, svaka kompanija zadržava svoj trenutni pristup dok neki od njenih administratora ne odobri nove opsege.

Otvorite meni Još radnji aplikacije i kliknite na Webhook. Unesite URL i kliknite na Kreiraj, a zatim kopirajte Tajni ključ za potpisivanje, koji Exayard prikazuje samo jednom. Svaka kompanija koja je instalirala aplikaciju šalje događaje koje pokrivaju opsezi koje je dodelila. Vaša aplikacija takođe prima app.installed, app.scopes_approved i app.uninstalled kada je neka kompanija instalira, odobri širi pristup ili je ukloni. Isporuke navode svoju kompaniju i potpisane su na isti način kao i ostali webhookovi.

Isti dijalog vam omogućava da isporuke pauzirate (Pauziraj) i nastavite (Nastavi), kao i da koristite Zameni tajni ključ i Izbriši webhook.

Povezane aplikacije navodi aplikacije instalirane u vašoj kompaniji. Svaki član može da ga vidi. Samo administratori instaliraju, uklanjaju ili odobravaju.

Svaki red prikazuje naziv aplikacije, da li je Pregledano, kompaniju koja ju je napravila, ko ju je instalirao i kada, kao i opsege koji su joj dodeljeni.

Otvorite link za instalaciju aplikacije ili kliknite na Instaliraj pored nje u odeljku Pronađi aplikacije. Dijalog prikazuje ko je napravio aplikaciju, da li je pregledana i koje opsege traži. Zatim izaberite:

Kliknite na Instaliraj. Ako vas aplikacija prijavljuje, Exayard vas zatim vodi dalje da završite prijavu u aplikaciju. Ako ste član, ali ne i administrator, dijalog vam kaže administrator koje kompanije može da je instalira. Kliknite na Kopiraj link da mu ga pošaljete.

Da biste kasnije promenili projekte, ponovo otvorite link za instalaciju i instalirajte sa novim izborom.

Kada aplikacija traži dodatne opsege, njen red prikazuje Traži širi pristup sa novim opsezima. Administrator klikne na Odobri da ih dodeli. Do tada aplikacija zadržava pristup koji je imala.

Otvorite meni Još radnji aplikacije, kliknite na Ukloni i potvrdite. Aplikacija odmah gubi pristup vašoj kompaniji i njeni webhookovi prestaju. AI rad koji je već započela i dalje se završava.

Pronađi aplikacije se pojavljuje unutar odeljka Povezane aplikacije. Navodi pregledane aplikacije koje su njihovi tvorci odlučili da navedu. Aplikacija koju vaša kompanija već ima prikazuje Instalirano. Kliknite na Instaliraj kod bilo koje druge aplikacije da otvorite dijalog za instalaciju.

Vaše lične veze navodi AI alate i druge aplikacije koje ste povezali sa svojim sopstvenim Exayard nalogom, poput ChatGPT-a ili Claude-a. Pojavljuje se na vrhu odeljka Povezane aplikacije i samo vi vidite svoje veze. Lična veza deluje u vaše ime, tako da može da pristupi svemu čemu i vi možete.

Svaka veza prikazuje kada je prvi i poslednji put korišćena i u kojim kompanijama je korišćena. Da biste je zaustavili, otvorite njen meni Još radnji, kliknite na Ukloni i potvrdite. Njen sledeći poziv se odbija. Veza ostaje na listi označena kao Uklonjeno, a Ponovo dozvoli joj vraća pristup. Da biste povezali novi alat, pogledajte Povezivanje Exa sa vašim AI asistentom.

Vaša aplikacija može preko API-ja da kreira Exayard kompanije za klijente koji Exayard koriste samo kroz vaš proizvod. Vaša kompanija poseduje ove kompanije i plaća AI rad koji se u njima izvršava. One nemaju sopstvene članove, a vaše aplikacije se u njima instaliraju automatski.

Nalozi za vaše klijente ih navodi za administratore, sa poljem Naziv svake kompanije i datumom kada je Kreirano. Kliknite na Ugasi i potvrdite da zatvorite jednu od njih. Svaka aplikacija u njoj gubi pristup.

Kartica Brzi početak sadrži gotov upit za AI uređivač poput Claude-a ili Cursor-a. Kliknite na Kopiraj upit i nalepite ga u svoj uređivač. Upit uključuje osnovni URL API-ja, format autentifikacije, opsege i šemu potpisivanja webhookova, tako da AI može da napravi integraciju koja radi i da vas pita za detalje koji su mu potrebni. Samo administratori vide ovu karticu, jer joj je potreban API ključ.

Kartica Dokumentacija vodi do pune dokumentacije za programere preko dugmeta Otvori dokumentaciju i do OpenAPI specifikacija, koja opisuje svaku rutu i šemu. Administratori vide i Poveži sa Claude ili Cursor, što otvara podešavanje za povezivanje AI asistenata sa Exayard-om.

Evidencija prikazuje zahteve upućene API-ju, od najnovijih. Svaki red prikazuje Metod, Putanja, Status, Vreme i Latencija. Kliknite na Učitaj još na dnu da vidite starije zahteve.

Administratori vide svaki zahtev. Članovi vide samo zahteve koji nisu stigli preko aplikacije.

Administratori mogu da filtriraju po polju Aplikacija, a zatim po jednom od ključeva te aplikacije. Svako može da unese Krajnji korisnik da vidi samo zahteve tog klijenta. Krajnji korisnik je vaš sopstveni ID za jednog od vaših klijenata. Vaš kod ga šalje sa svakim zahtevom u zaglavlju Exayard-End-User. Nikada ne koristite adresu e-pošte kao ID.

Izaberite red da vidite sve njegove detalje, uključujući ID zahteva, aplikaciju i krajnjeg korisnika, kao i Telo zahteva i Telo odgovora. Koristite evidenciju da potvrdite da je poziv uspeo ili da saznate zašto integracija ne radi.

Administratori vide koliko je svaka aplikacija potrošila ovog meseca u odeljku Potrošnja po aplikacijama u Podešavanja, a zatim Potrošnja. Tu su navedene i vaše sopstvene aplikacije. Ispod svake aplikacije, Po ključu prikazuje koliko je potrošio svaki ključ, a Najveći krajnji korisnici prikazuje pet krajnjih korisnika koji su najviše potrošili. Potrošnja koja nije vezana za neki od ključeva aplikacije prikazuje se kao Ostalo.

Mesečno ograničenje za AI aplikacije je najviše koliko njen AI rad sme da košta vašu kompaniju u svakom obračunskom mesecu. Da biste ga postavili, otvorite meni Još radnji aplikacije u odeljku Potrošnja po aplikacijama i kliknite na Postavi mesečno ograničenje za AI. Unesite iznos u svojoj valuti obračuna i kliknite na Sačuvaj. Sačuvajte prazno polje da uklonite ograničenje.

Kada aplikacija dostigne svoje ograničenje, njen AI rad se odbija do kraja obračunskog meseca, čak i dok vaša kompanija još ima preostale AI potrošnje. Sopstvena ograničenja vaše kompanije i dalje važe. AI rad koji ljudi sami pokrenu nikada se ne računa u ograničenje aplikacije.