# Luo API-avain, jotta omat työkalusi voivat lukea lipunmyyntiäsi | Ticket Fairy -oppaat

1. [Ticket Fairy](https://www.ticketfairy.com/)
2. [Oppaat](https://www.ticketfairy.com/fi/guides)
3. Luo API-avain, jotta omat työkalusi voivat lukea lipunmyyntiäsi

Kehittäjät ja API

# Luo API-avain, jotta omat työkalusi voivat lukea lipunmyyntiäsi

API-avain antaa omalle taulukollesi, hallintapaneelillesi tai agentillesi pääsyn samoihin tietoihin kuin sinulla, ilman että hallintapaneelin salasana vaihtaa omistajaa. Useita tapahtumia järjestävät promoottorit pitävät lipunmyynnin työkaluissa, joita he käyttävät jo muutenkin.

Anna komentoriville, skriptille tai agentille oma avain lipunmyyntiisi, valitse sen voimassaoloaika ja kumoa se heti tarvittaessa.

Kenelle:  Omien työkalujen, skriptien tai agenttien yhdistäminen lipunmyyntiin

Kestää:  7 minuuttia

- [Avaa tilisi asetukset](#step-1)
- [Nimeä tunnus sitä käyttävän työkalun mukaan](#step-2)
- [Valitse voimassaoloaika](#step-3)
- [Kopioi tunnus ennen ikkunan sulkemista](#step-4)
- [Luo tapahtumien API-rajapintojen brändiavain](#step-5)

## Ennen aloitusta

- Tiedät, mikä työkalu tarvitsee käyttöoikeuden: kannettava tietokone, palvelin, ajastettu skripti tai agentti. Yksi tunnus työkalua kohden antaa sinulle mahdollisuuden poistaa yhden käyttöoikeuden koskematta muihin.
- Sinulla on turvallinen paikka tunnuksen säilyttämiseen, kuten salasananhallinta tai koontijärjestelmäsi salaisuussäilö. Tunnus näytetään kerran eikä enää uudelleen.

1. ## Avaa tilisi asetukset

   Avaa tilisi asetukset ja etsi **Henkilökohtaiset käyttöoikeustunnukset**.

   **Huomautus:** Nämä ovat omalla tililläsi, eivät brändillä, koska tunnus sisältää käyttöoikeutesi. Tiimikaveri, joka tarvitsee oman käyttöoikeuden, luo oman tunnuksensa.
          ![Ticket Fairy Henkilökohtaiset käyttöoikeustunnukset -kortti, jossa näkyvät tunnukset sekä niiden luonti-, viimeisin käyttö- ja vanhenemispäivät](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--personal-access-tokens.png)    Tilin tunnukset, joista yksi on parhaillaan kierrätettävänä.
2. ## Nimeä tunnus sitä käyttävän työkalun mukaan

   Valitse **Uusi henkilökohtainen käyttöoikeustunnus** ja kirjoita työkalun nimi kohtaan **Tunnuksen nimi**.

   **Huomautus:** Nimeä tunnus kannettavan tietokoneen, palvelun tai skriptin mukaan, älä tehtävän mukaan. Näin löydät oikean rivin, kun poistat käyttöoikeuden.
3. ## Valitse voimassaoloaika

   Avaa **Määritä oma vanhenemisaika** ja valitse työkalulle sopiva kesto.

   **Huomautus:** Vuosi on oletus ja pisin mahdollinen kesto. Valitse kertaluonteiselle skriptille tunti tai seitsemän päivää, koska lyhyt voimassaoloaika rajoittaa vuodon aiheuttamia vahinkoja.
4. ## Kopioi tunnus ennen ikkunan sulkemista

   Valitse **Luo tunnus** ja kopioi näytettävä arvo salasananhallintaasi.

   **Huomautus:** Tunnus näytetään kerran. Jos suljet ikkunan kopioimatta sitä, sinun on kumottava tunnus ja luotava uusi.
5. ## Luo tapahtumien API-rajapintojen brändiavain

   Etsi samalta sivulta **API-avain** ja valitse **Luo API-avain**.

   **Huomautus:** Tätä avainta tapahtumien API-rajapinnat, kuten suosittelijoiden tulostaulukko, pyytävät. Avaimen luominen uudelleen estää kaikkien vanhaa avainta käyttävien sovellusten toiminnan, kunnes päivität ne.
          ![Ticket Fairy API-avain- ja Webhook API-avain -kortit, joissa kummassakin näkyy avain sekä sen kopiointi- ja uudelleenluontitoiminnot](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--api-keys.png)    Molemmat avaimet sen jälkeen, kun ne on luotu.

## Kokeile näitä vaiheita omassa tapahtumassasi

Luo ilmainen tili, rakenna tapahtumasi ja seuraa yllä olevia vaiheita omassa hallintapaneelissasi. Se vie muutaman minuutin, eikä sinun tarvitse varata myyntipuhelua.

    Sähköpostiosoitteesi    [Luo ilmainen tili](https://manage.ticketfairy.com/welcome) [Varaa esittely](https://www.ticketfairy.com/fi/event-ticketing/book-a-demo)

Ei käyttöönottomaksuja. Ei pakollista kuukausimaksua. Luottokorttia ei tarvita.

## Tai anna sen hoitua puolestasi

Fai voi avata sivun, jolla tunnukset ovat. Tunnuksen luominen jää sinulle, koska tunnus näytetään vain kerran ja vain sinulle.

### Hallintapaneelissasi, Fain kanssa

Avaa tilini asetukset, jotta voin luoda käyttöoikeustunnuksen

### Omasta avustajastasi, MCP:n kautta

Yhdistä avustajasi [MCP-palvelimeemme](https://www.ticketfairy.com/mcp-server) ja pyydä sitä:

Pidä `--read-only` MCP-määrityksessäsi. Tämä tehtävä vain lukee tietoja, joten avustajasi ei tarvitse muutoksia tekeviä työkaluja.

Valitse brändi \<BRAND NAME\> ja näytä sen tapahtumat

## Päätteeltä

Asenna CLI osoitteesta [CLI-sivultamme](https://www.ticketfairy.com/cli), kirjaudu komennolla `ticketfairy auth login` ja valitse brändi, jonka parissa työskentelet, komennolla `ticketfairy brand use <BRAND_ID>`. `ticketfairy brand list` ja `ticketfairy event list` näyttävät muiden komentojen käyttämät tunnisteet.

Kirjaudu komentoriville tunnuksella ja tarkista sitten, mille brändeille se pääsee.

### Kirjautuu luomallasi tunnuksella

ticketfairy auth login

### Näyttää brändit, joiden puolesta tunnus voi toimia

ticketfairy brand list

## Anna Fain hoitaa se puolestasi

Fai toimii Ticket Fairy -hallintapaneelissasi. Luo tili, avaa Fai ja liitä yllä oleva kehote.

   [Luo ilmainen tili](https://manage.ticketfairy.com/welcome) [Varaa esittely](https://www.ticketfairy.com/fi/event-ticketing/book-a-demo)

Ei käyttöönottomaksuja. Ei pakollista kuukausimaksua. Luottokorttia ei tarvita.

## Vaihda tunnus ilman käyttökatkoa

1. ### Luo uusi tunnus vanhan tilalle

   Valitse riviltä **Uusi tunnus** ja kopioi uusi tunnus.

   **Huomautus:** Uuden tunnuksen luominen tekee samalla nimellä uuden tunnuksen ja pitää vanhan toiminnassa siirtymäajan. Päivitä kaikki skriptit ja palvelut ennen ajan päättymistä.
2. ### Erota rivit toisistaan jälkikäteen

   Etsi vanhempaa tunnusta merkitsevä tunniste ennen kuin poistat mitään.

   **Huomautus:** Molemmilla riveillä on sama nimi, joten tunniste estää sinua poistamasta uutta tunnusta vahingossa käytöstä.

Fai voi avata sivun. Uuden tunnuksen luominen ja kopiointi jäävät sinulle, koska arvo näytetään vain kerran ja vain sinulle.

### Hallintapaneelissasi, Fain kanssa

Avaa tilini asetukset, jotta voin luoda käyttöoikeustunnuksen uudelleen

### Omasta avustajastasi, MCP:n kautta

Pidä `--read-only` MCP-määrityksessäsi. Tämä tehtävä vain lukee tietoja, joten avustajasi ei tarvitse muutoksia tekeviä työkaluja.

Valitse brändi \<BRAND NAME\> ja näytä sen tapahtumat

### Päätteeltä

Kirjaudu uudelleen sisään uudella tunnuksella.

#### Kirjautuu kopioimallasi tunnuksella

ticketfairy auth login

## Poista käyttöoikeus

1. ### Kumoa tunnus heti, jos se vuotaa

   Valitse kyseisen työkalun riviltä **Kumoa**.

   **Huomautus:** Kumoa-toiminto pysäyttää tunnuksen heti, eikä sitä voi perua. Työkalu tarvitsee uuden tunnuksen toimiakseen jälleen.

Fai voi avata sivun. Sinä vahvistat kumoamisen, koska se pysäyttää käytössä olevan integraation heti.

### Hallintapaneelissasi, Fain kanssa

Avaa tilini asetukset, jotta voin kumota käyttöoikeustunnuksen

### Omasta avustajastasi, MCP:n kautta

Pidä `--read-only` MCP-määrityksessäsi. Tämä tehtävä vain lukee tietoja, joten avustajasi ei tarvitse muutoksia tekeviä työkaluja.

Valitse brändi \<BRAND NAME\> ja näytä sen tapahtumat

### Päätteeltä

Tarkista, mihin jäljellä olevat tunnukset yhä pääsevät.

#### Näyttää brändit, joiden puolesta nykyinen tunnus voi toimia

ticketfairy brand list

## Kysymyksiä joita sinulla voi olla

Mitä tunnusta käytän komentorivillä?:  Henkilökohtaista käyttöoikeustunnusta. Komentorivi, omat skriptisi ja agenttisi kirjautuvat kaikki sillä, ja ne saavat samat käyttöoikeudet kuin hallintapaneelitilisi.

Mihin API-avainta sitten tarvitaan?:  Tapahtumien API-rajapintoihin, kuten suosittelijoiden tulostaulukkoon. Avain myönnetään sitä pyytävälle tilille, joten useamman henkilön käytössä oleva työkalu tarvitsee tiimiin jäävän tilin avaimen.

Voiko tunnus tehdä kaiken, minkä minäkin voin?:  Kyllä, omien käyttöoikeuksiesi rajoissa. Siksi yksi tunnus työkalua kohden ja lyhyt vanhenemisaika ovat ylimääräisen minuutin arvoisia. Tunnuksen voi myös kumota heti, eikä kumoamista ole rajoitettu.

Kuinka monta tunnusta voin luoda?:  Kymmenen tunnissa, mukaan lukien uudet tunnukset. Et voi luoda uutta tunnusta, kun viisikymmentä tunnusta on jo aktiivisena. Odottaminen tyhjentää tuntikohtaisen määrän. Viidenkymmenen tunnuksen raja edellyttää, että kumoat yhden, jota et enää tarvitse. Uusi tunnus vanhan tilalle ei kuulu tähän rajaan, joten tunnuksia voi olla viisikymmentäyksi, kunnes vanhan tunnuksen siirtymäaika päättyy.

Mitä jos suljen ikkunan kopioimatta tunnusta?:  Kumoa tunnus ja luo uusi. Arvoa ei näytetä enää uudelleen, joten sitä ei voi palauttaa eikä aloittamisesta uudelleen aiheudu mitään haittaa.

## Jäikö vielä kysyttävää?

Varaa esittely, niin vastaamme siihen puhelussa sinun tapahtumatyyppisi mukaan. Tai luo tili ja katso itse.

   [Varaa esittely](https://www.ticketfairy.com/fi/event-ticketing/book-a-demo) [Luo ilmainen tili](https://manage.ticketfairy.com/welcome)

Ei käyttöönottomaksuja. Ei pakollista kuukausimaksua. Luottokorttia ei tarvita.

## Aiheeseen liittyvät oppaat

- [Lisää tapoja käyttää Ticket Fairyä](https://www.ticketfairy.com/fi/event-ticketing/features)
- [Get a webhook each time you take a ticket order](https://www.ticketfairy.com/fi/guides/get-a-webhook-when-a-ticket-sells)
- [Can you sell tickets directly from your own website?](https://www.ticketfairy.com/fi/guides/sell-tickets-on-your-own-website)
- [Kutsu tiimisi tapahtumiisi ja valitse, mitä kukin voi tehdä](https://www.ticketfairy.com/fi/guides/invite-your-team)
- [Kaikki Ticket Fairy -oppaat](https://www.ticketfairy.com/fi/guides)

## Tee tämä omassa tapahtumassasi

Luo tili, rakenna tapahtumasi ja seuraa vaiheita omassa hallintapaneelissasi. Sinun ei tarvitse varata myyntipuhelua.

  [Luo ilmainen tili](https://manage.ticketfairy.com/welcome) [Varaa esittely](https://www.ticketfairy.com/fi/event-ticketing/book-a-demo)

## Myy lippuja Ticket Fairyn kanssa

Kaikki näissä oppaissa esitelty on hallintapaneelissasi rekisteröitymispäivästä alkaen.

- Rakenna tapahtumasi minuuteissa
- Ilmaiset tapahtumat ovat ilmaisia
- Fai, apuohjaajasi, on mukana valmiina

 [Luo ilmainen tili](https://manage.ticketfairy.com/welcome)

Ei käyttöönottomaksuja. Ei pakollista kuukausimaksua. Luottokorttia ei tarvita.

## Katso se puhelussa

Varaa esittely, niin näytämme, miten Ticket Fairy hoitaa sinun tapahtumatyyppisi.

 [Varaa esittely](https://www.ticketfairy.com/fi/event-ticketing/book-a-demo) [Lisää tapoja käyttää Ticket Fairyä](https://www.ticketfairy.com/fi/event-ticketing/features)

### Vinkkejä lippujen myynnin kasvattamiseen

Käytännön neuvoja järjestäjiltä, joiden liput myydään loppuun, sekä jokainen uusi opas heti sen ilmestyttyä.

Kunnioitamme yksityisyyttäsi. Voit peruuttaa milloin tahansa.