> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API-asetukset

> Luo ja poista API-tokenit, joilla kehittäjäsi yhdistää omat järjestelmäsi Zippendo-palveluun.

**API-asetukset** on paikka, jossa luot **API-tokeneita**. API-token antaa omien järjestelmiesi tai sinulle työskentelevän kehittäjän keskustella suoraan Zippendo-palvelun kanssa: luoda lähetyksiä, lukea tilauksia tai yhdistää varasto- tai taustajärjestelmä.

## Mistä sen löytää

Avaa organisaatiovalikko sivupalkin alareunasta, napsauta **Hallitse** ja sitten **API-asetukset**-välilehteä. Näet tokenisi ja **Lisää API-token** -painikkeen.

Jokainen paketti sisältää API-tokenit: Free enintään 2, Standard 5, Growth 10, Pro ja Enterprise rajattomasti.

## Luo API-token

<Steps>
  <Step title="Avaa ikkuna">
    Napsauta **Lisää API-token** (tai **Luo ensimmäinen token**, jos luettelo on tyhjä).
  </Step>

  <Step title="Nimeä token">
    Kirjoita **Tokenin nimi \***, esimerkiksi "WMS-integraatio" tai "Taustajärjestelmä", jotta tunnistat sen myöhemmin. Voit myös asettaa **Voimassa (päivää)** (enintään 365) ja, jos organisaatiossasi on brändejä, **Rajaa brändiin**.
  </Step>

  <Step title="Valitse oikeudet">
    Valitse tokenin tarvitsemat **Oikeudet \***, esimerkiksi **Lähetysten katselu** ja **Lähetysten muokkaus**.
  </Step>

  <Step title="Luo ja kopioi token">
    Napsauta **Luo token**. Koko token näytetään kerran kohdassa **API-token luotu**. Napsauta **Kopioi** ja tallenna se turvalliseen paikkaan: et näe sitä enää, kun suljet ikkunan.
  </Step>
</Steps>

<Warning>
  Käsittele API-tokenia kuin salasanaa. Älä jaa sitä äläkä laita sitä koodiin, jonka muut näkevät. Jos token vuotaa, poista se ja luo uusi.
</Warning>

## Tokenin käyttö

Kehittäjäsi lähettää tokenin jokaisen pyynnön `Authorization`-otsakkeessa:

`Authorization: Bearer YOUR_TOKEN`

Kutsuttava osoite ja kaikki pyynnöt ovat sivulla [API reference](/docs/api-reference/overview). Token yltää vain oman organisaatiosi tietoihin.

## Tokenin rajaaminen brändiin

Jos organisaatiosi käyttää [brändejä](/docs/fi/settings/brands), voit asettaa **Rajaa brändiin** tokenia luodessasi. Jokainen tällä tokenilla tehty pyyntö voi silloin lukea ja kirjoittaa vain kyseisen brändin tietoja. Et voi muuttaa tai poistaa brändiä myöhemmin, joten luo uusi token, jos tarvitset toisen.

Token ilman brändiä toimii koko organisaatiolle. Kehittäjä voi silti kohdistaa yksittäisen pyynnön yhteen brändiin `X-Zippendo-Brand`-otsakkeella ja asettaa luettelopyyntöjen oletuksen `X-Zippendo-Brand-Scope`-otsakkeella (`own`, `shared` tai `both`). Katso [Brändit](/docs/fi/settings/brands) ja [API reference](/docs/api-reference/overview).

## Tokenin poistaminen

Jos haluat estää tokenia toimimasta, esimerkiksi kun integraatio poistetaan käytöstä tai token paljastui, napsauta **Poista** sen rivillä kohdassa **API-asetukset**. Kirjoita tokenin nimi isoilla kirjaimilla ja vahvista. Jokainen järjestelmä, joka käyttää tokenia, lakkaa toimimasta heti. Luo uusi token, jos sen pitää jatkaa toimintaa.

Jokainen kenttä tarkemmin: [Luo API-token](/docs/fi/how-to/create-an-api-token).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.