Innstillingene for Utvikler er stedet der du kobler Exayard til din egen kode og til apper som andre firmaer bygger. Åpne Innstillinger og deretter Utvikler. Bare firmaadministratorer ser siden i Innstillinger-menyen. Et medlem som åpner siden, kan lese den, men ikke endre noe.

Apper, API-nøkler, webhooks og logger følger med alle abonnementer, også Free. Bare AI-arbeid belastes.

En app er en av integrasjonene dine, for eksempel "Acme-kalkulator" eller "Nattlig synkronisering". Hver API-nøkkel hører til en app. Apper er den første delen på siden. Alle medlemmer kan lese den. Bare administratorer oppretter eller endrer apper.

Klikk på Ny app og fyll inn Navn, Beskrivelse, Nettsted, E-post for kundestøtte og Tilgangsområder. Tilgangsområdene er delt i lese- og skrivetilgang per ressurs, for eksempel read:projects og write:estimates. Apper kan ikke be om tilgangsområdet admin:org. Et firma kan ha opptil 25 apper.

Hver app viser når den ble opprettet, og hastighetsgrensen sin, for eksempel "Opptil 60 forespørsler i minuttet per firma og 600 totalt". Menyen Flere handlinger for appen inneholder:

En API-nøkkel lar din egen kode kalle Exayard-API-et. Nøkler ligger inne i en app, under Nøkler. En nøkkel fungerer i appens eget firma, så du trenger ikke å oppgi noen firma-ID.

For å opprette en nøkkel klikker du på Ny nøkkel i appen. Gi nøkkelen et Navn, for eksempel "Produksjon". Under Tilgangsområder velger du Alle for alle tilgangsområdene appen har, eller Spesifikke for å velge færre. Angi eventuelt en dato for Utløper hvis nøkkelen er for kortvarig arbeid. Nøkkelen fungerer ut den dagen. Klikk på Opprett.

Exayard viser hele nøkkelen én gang. Kopier den da, fordi den aldri vises igjen. Exayard beholder bare en kryptert kopi, så en mistet nøkkel kan ikke gjenopprettes. Opprett en ny og tilbakekall den gamle.

En nøkkel begynner med exa_live_. En nøkkel som er opprettet i en sandkasse, begynner med exa_test_. Etter at du har opprettet den, viser nøkkelen navnet sitt, en forhåndsvisning som exa_live_...AbCd, og Sist brukt eller Aldri brukt. En nøkkel med utløpsdato viser Utløper og datoen, og en utløpt nøkkel viser Utløpt.

En app kan ha opptil 25 aktive nøkler. En utløpt nøkkel teller fortsatt til du tilbakekaller den. For å bytte nøkler uten avbrudd oppretter du en ny nøkkel, flytter serverne dine over til den og tilbakekaller deretter den første.

Åpne menyen Nøkkelhandlinger for en nøkkel for å Gi nytt navn eller Tilbakekall den. Tilbakekalling kan ikke angres, og nøkkelen slutter å fungere innen 30 sekunder.

Hvis en nøkkel dukker opp på et offentlig sted, for eksempel i et offentlig kodelager, tilbakekaller Exayard den, sender e-post til administratorene dine og beholder den i listen merket Funnet offentlig, tilbakekalt.

Når et annet firma har installert appen din, viser dialogen for ny nøkkel også Fungerer i. Dette firmaet er standard. Alle firmaer som har installert den oppretter en nøkkel som serveren din bruker i hvert av disse firmaene. Hvert kall angir da firmaet sitt i headeren Exayard-Organization-Id.

De samme nøklene kobler til verktøyene uten kode. Se Koble Exayard til Zapier, Koble Exayard til Make og Koble Exayard til n8n. For AI-assistenter, se Koble Exa til AI-assistenten din.

Nøkler som ble opprettet før nøkler lå i apper, begynner med ak_. De fortsetter å fungere, men det kan ikke opprettes nye. De vises under Eldre nøkler nederst på siden, bare så lenge det finnes noen.

Alle administratorer ser alle firmaets nøkler der, uansett hvem som opprettet dem. En nøkkel som noen andre har opprettet, viser Laget av og personens navn. Hver person ser også sine egne personlige nøkler. Klikk på søppelbøtteikonet for å Tilbakekall en nøkkel. Den slutter å fungere umiddelbart.

En sandkasse er et testfirma som er koblet til ditt. Bruk den til å bygge og teste en integrasjon uten å røre de virkelige prosjektene dine. Bare administratorer ser Sandkasser.

Klikk på Ny sandkasse, gi den et Navn, og klikk på Opprett. Et firma kan ha opptil 5 sandkasser. Åpne bytter deg inn i sandkassen, der firmavelgeren merker den Sandkasse. Opprett en app og en nøkkel der som vanlig. Nøklene begynner med exa_test_. For å gå i produksjon oppretter du den samme appen og nøkkelen i det virkelige firmaet ditt og bytter ut nøkkelen i koden din.

En sandkasse følger firmaets abonnement, og firmaet ditt betaler for forbruket i den. Den har ingen egen fakturering og får ikke noe eget månedlig AI-forbruk. Webhooks og integrasjoner fungerer som i det virkelige firmaet ditt.

En sandkasse sender ikke e-poster for tilbudsdeling eller signerte kopier til personer utenfor den, og den sender ingen SMS-er. De vises som "Ikke sendt fordi dette firmaet er en sandkasse". Invitasjoner til å bli med i sandkassen sendes som vanlig.

Mengdeuttak og fillesing i en sandkasse returnerer resultater som er kopiert fra eksempelprosjektet vårt, uten kostnad. Mengdeuttaket, sidene i det og webhooken som sendes når mengdeuttaket er ferdig, er merket som eksempler. Kalkyler, tilbud, elementsøk og chat svarer også med eksempler, uten kostnad.

For å fjerne en sandkasse klikker du på Slett på raden, og deretter på Slett sandkasse. Sandkassen stenges, nøklene slutter å fungere, og dataene slettes senere.

En webhook ber Exayard varsle serveren din når noe skjer i firmaet ditt. Alle medlemmer kan lese listen. Bare administratorer legger til eller endrer webhooks.

Klikk på Opprett webhook, skriv inn URL-en som skal motta leveransene, og legg eventuelt til en Beskrivelse. Velg hvilke Hendelser som skal sendes. Velg Alle for å motta alle hendelser, også nye, eller Spesifikke for å velge fra listen. Alle hendelser og innholdet deres står i katalogen over webhook-hendelser.

Når du oppretter en webhook, viser Exayard Signeringshemmelighet for den én gang. Kopier den da, fordi den ikke vises igjen.

Åpne menyen Flere handlinger for en webhook for resten:

En testhendelse og en ny sending sendes én gang og forsøkes aldri på nytt.

Hver leveranse har en Exayard-Signature-header på formen t=<unix>,v1=<digest>. Exayard lager signaturen ved å slå sammen tidsstempelet og forespørselsinnholdet, og deretter signere dem med HMAC-SHA256 ved hjelp av webhookens hemmelighet.

Hver leveranse har også headerne Exayard-Event-Id, Exayard-Event-Type og Exayard-Organization-Id. JSON-innholdet har et organizationId-felt som angir hvilket firma hendelsen kom fra. Headeren inneholder den samme ID-en, slik at du kan rute en leveranse før du leser innholdet. Signaturen dekker hele innholdet, inkludert organizationId.

Siden hver leveranse angir firmaet sitt, kan én mottakeradresse betjene mange firmaer. Registrer den samme URL-en i hvert firma, og rut hver leveranse etter organizationId. Hver webhook har sin egen hemmelighet, så velg hemmeligheten etter Exayard-Organization-Id før du verifiserer.

For å verifisere en leveranse beregner du signaturen på nytt med hemmeligheten din, bekrefter at tidsstempelet ligger innenfor fem minutter fra nå, og sammenligner sjekksummene.

En mislykket leveranse forsøkes opptil 10 ganger totalt, over omtrent 80 timer, med stadig lengre ventetid mellom forsøkene. Hvert forsøk sender det samme innholdet og den samme hendelses-ID-en. En omdirigering regnes som en feil.

Appen din fungerer i ditt eget firma så snart du har opprettet den. Hver app har også en del som heter La andre firmaer installere denne appen. Den viser om appen er Gjennomgått, Gjennomgang forespurt eller Ikke gjennomgått, Påloggingsadresser, Klient-ID og hvor mange firmaer som kan installere den.

Administratorer åpner menyen Installasjonshandlinger for disse:

En ny app kan installeres i opptil 25 firmaer i tillegg til ditt eget, og den vises ikke i Finn apper. Firmaer under Kontoer for kundene dine teller ikke mot den grensen. Når appen er godkjent, viser den Gjennomgått, og installasjonsgrensen oppheves. Bruk Vis i Finn apper for å vise den i katalogen til alle firmaer, eller Skjul fra Finn apper for å fjerne den derfra. En app som er Suspendert, kan ikke kalle Exayard før kundestøtten opphever suspensjonen, og installasjonene beholdes.

Når du fjerner tilgangsområder fra en app, mister alle installasjoner dem umiddelbart. Når du legger til tilgangsområder, beholder hvert firma sin nåværende tilgang til en av firmaets administratorer godkjenner de nye tilgangsområdene.

Åpne menyen Flere handlinger for appen og klikk på Webhook. Skriv inn URL og klikk på Opprett, og kopier deretter Signeringshemmelighet, som Exayard bare viser én gang. Hvert firma som har installert appen, sender hendelsene som tilgangsområdene det har gitt, dekker. Appen din mottar også app.installed, app.scopes_approved og app.uninstalled når et firma installerer den, godkjenner utvidet tilgang eller fjerner den. Leveransene angir firmaet sitt og signeres på samme måte som andre webhooks.

I den samme dialogen kan du Sett på pause og Gjenoppta leveranser, Roter hemmelighet og Slett webhook.

Tilkoblede apper viser appene som er installert i firmaet ditt. Alle medlemmer kan se den. Bare administratorer installerer, fjerner eller godkjenner.

Hver rad viser appens navn, om den er Gjennomgått, firmaet som bygde den, hvem som installerte den og når, og tilgangsområdene den har fått.

Åpne appens installasjonslenke, eller klikk på Installer ved siden av den i Finn apper. Dialogen viser hvem som har bygd appen, om den er gjennomgått, og hvilke tilgangsområder den ber om. Velg deretter:

Klikk på Installer. Hvis appen logger deg inn, sender Exayard deg deretter videre for å fullføre innloggingen i appen. Hvis du er medlem, men ikke administrator, forteller dialogen deg hvilket firmas administrator som kan installere den. Klikk på Kopier lenke for å sende den til vedkommende.

For å endre prosjektene senere åpner du installasjonslenken på nytt og installerer med det nye valget.

Når en app ber om flere tilgangsområder, viser raden Ber om mer tilgang med de nye tilgangsområdene. En administrator klikker på Godkjenn for å gi dem. Inntil da beholder appen tilgangen den hadde.

Åpne menyen Flere handlinger for appen, klikk på Fjern og bekreft. Appen mister tilgangen til firmaet ditt umiddelbart, og webhookene dens stopper. AI-arbeid den allerede hadde startet, fullføres likevel.

Finn apper vises inne i Tilkoblede apper. Den viser gjennomgåtte apper som utviklerne har valgt å vise. En app som firmaet ditt allerede har, viser Installert. Klikk på Installer på en hvilken som helst annen app for å åpne installasjonsdialogen.

Dine personlige tilkoblinger viser AI-verktøyene og andre apper du har koblet til din egen Exayard-konto, for eksempel ChatGPT eller Claude. Den vises øverst i Tilkoblede apper, og bare du ser dine egne. En personlig tilkobling handler som deg, så den kan nå alt du kan nå.

Hver tilkobling viser når den først og sist ble brukt, og hvilke firmaer den ble brukt i. For å stoppe en tilkobling åpner du menyen Flere handlinger for den, klikker på Fjern og bekrefter. Det neste kallet den gjør, avvises. Tilkoblingen blir stående i listen merket Fjernet, og Tillat igjen slipper den inn igjen. For å koble til et nytt verktøy, se Koble Exa til AI-assistenten din.

Appen din kan opprette Exayard-firmaer gjennom API-et for kunder som bare bruker Exayard gjennom produktet ditt. Firmaet ditt eier disse firmaene og betaler for AI-arbeidet som utføres i dem. De har ingen egne medlemmer, og appene dine installeres automatisk i dem.

Kontoer for kundene dine viser dem for administratorer, med hvert firmas Navn og datoen det ble Opprettet. Klikk på Si fra deg og bekreft for å stenge et firma. Alle apper i det mister tilgangen.

Kortet Hurtigstart inneholder en ferdiglaget ledetekst for et AI-redigeringsverktøy som Claude eller Cursor. Klikk på Kopier ledetekst og lim den inn i redigeringsverktøyet ditt. Ledeteksten inneholder API-ets basis-URL, autentiseringsformatet, tilgangsområdene og signeringsordningen for webhooks, slik at AI-en kan bygge en fungerende integrasjon og be deg om detaljene den trenger. Bare administratorer ser dette kortet, fordi det krever en API-nøkkel.

Kortet Dokumentasjon lenker til den fullstendige utviklerdokumentasjonen med Åpne dokumentasjonen, og til OpenAPI-spesifikasjon, som beskriver alle ruter og skjemaer. Administratorer ser også Koble til Claude eller Cursor, som åpner oppsettet for å koble AI-assistenter til Exayard.

Logger viser forespørslene som er gjort til API-et, med de nyeste først. Hver rad viser Metode, Sti, Status, Tid og Forsinkelse. Klikk på Last inn flere nederst for å se eldre forespørsler.

Administratorer ser alle forespørsler. Medlemmer ser bare forespørslene som ikke kom gjennom en app.

Administratorer kan filtrere etter App, og deretter etter en av appens nøkler. Alle kan skrive inn en Sluttbruker for å se bare den kundens forespørsler. En sluttbruker er din egen ID for en av kundene dine. Koden din sender den med hver forespørsel i headeren Exayard-End-User. Bruk aldri en e-postadresse som ID.

Velg en rad for å se alle detaljer, inkludert Forespørsels-ID, appen og sluttbrukeren, og Forespørselsinnhold og Svarinnhold. Bruk loggene til å bekrefte at et kall fungerte, eller til å finne ut hvorfor en integrasjon ikke fungerer.

Administratorer ser hva hver app har brukt denne måneden under Forbruk per app i Innstillinger og deretter Forbruk. Dine egne apper vises også der. Under hver app viser Etter nøkkel hva hver nøkkel har brukt, og Største sluttbrukere viser de fem sluttbrukerne som har brukt mest. Forbruk som ikke er knyttet til en av appens nøkler, vises som Annet.

En apps månedlige AI-grense er det meste appens AI-arbeid kan koste firmaet ditt hver faktureringsmåned. For å angi den åpner du menyen Flere handlinger for appen under Forbruk per app og klikker på Angi månedlig AI-grense. Skriv inn et beløp i faktureringsvalutaen din og klikk på Lagre. Lagre et tomt felt for å fjerne grensen.

Når appen når grensen sin, avvises AI-arbeidet dens resten av faktureringsmåneden, selv om firmaet ditt fortsatt har AI-forbruk igjen. Firmaets egne grenser gjelder fortsatt. AI-arbeid som personer starter selv, telles aldri mot en apps grense.