> ## 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.

# Luo API-token

> Luo API-token kohdassa Asetukset → API-asetukset, jotta omat järjestelmäsi voivat yhdistää Zippendoon - nimi, vanheneminen, oikeudet, tokenin kopiointi kerran ja sen poistaminen.

**API-token** antaa omille järjestelmillesi tai puolestasi työskentelevälle kehittäjälle mahdollisuuden yhdistää Zippendoon: luoda lähetyksiä, lukea tilauksia, rekisteröidä webhookeja ja tehdä kaiken muun, mitä [API-viitteessä](/docs/api-reference/overview) on. Luot tokenit kohdassa **API-asetukset**. Zippendo näyttää koko tokenin vain kerran, heti luomisen jälkeen.

Asetusten esittely: [Asetukset, tiimi ja brändit](/docs/fi/tutorials/settings-team-brands). Ensimmäinen pyyntö: [REST API -pikaopas](/docs/fi/quickstarts/rest-api). Toimitushinnat kassalla: [Hae toimitushinta](/docs/fi/how-to/shipping-quotes).

<Info>
  Jokainen paketti sisältää API-tokeneita: Free enintään 2, Standard 5, Growth 10, Pro ja Enterprise rajattomasti. Kun raja täyttyy, tokenin luominen epäonnistuu viestillä **Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä.** Poista token, jota et enää käytä, tai vaihda pakettia.
</Info>

## Mistä se löytyy

Avaa sivupalkin alareunan organisaatiovalikko, napsauta **Hallitse** ja sitten **API-asetukset**-välilehteä. Painike tokenin luomiseen on **Lisää API-token** oikeassa yläkulmassa.

<Frame caption="API-tokenit: nimi, kunkin tokenin alku, oikeudet ja viimeisin käyttö">
  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/create-an-api-token/01-api-settings-light.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=fb6d10895511470be143f23fd6e671e7" alt="API-asetukset-välilehti, jossa API-tokenien luettelo ja Lisää API-token otsakkeessa" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/create-an-api-token/01-api-settings-light.png" />

  <img src="https://mintcdn.com/zippendo/0ssbVvEMS1KbsZlG/images/fi/how-to/create-an-api-token/01-api-settings-dark.png?fit=max&auto=format&n=0ssbVvEMS1KbsZlG&q=85&s=c3bbc81d35bf244a93c2d5018d80829f" alt="API-asetukset-välilehti, jossa API-tokenien luettelo ja Lisää API-token otsakkeessa" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/create-an-api-token/01-api-settings-dark.png" />
</Frame>

## API-tokenien luettelo

| Sarake | Mitä se näyttää |
| - | - |
| **Nimi** | Antamasi **Tokenin nimi**. |
| **Token** | Tokenin ensimmäiset merkit ja perässä `...`. Koko tokenia ei koskaan näytetä tässä. |
| **Oikeudet** | Enintään kolme oikeutta, kuten **Lähetysten katselu**, loput on tiivistetty. **Ei oikeuksia**, jos mitään ei valittu. |
| **Viimeksi käytetty** | Milloin tokenia käytettiin viimeksi, tai **Ei koskaan**. |
| **Luoja** | Tiimin jäsen, joka loi sen. |
| **Vanhenee** | Vanhenemispäivä tai **Ei koskaan**. Menneisyydessä oleva päivämäärä näkyy punaisella. |
| **Luotu** | Milloin se luotiin. |

Ainoa asia, jonka voit tehdä luettelon tokenille, on **Poista** se. Tokenia ei voi muokata tai nimetä uudelleen.

Kun tokeneita ei vielä ole, luettelossa lukee **Ei API-tokeneita** ja näkyvillä on **Luo ensimmäinen token** -painike.

## Luo token

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

  <Step title="Nimeä token">
    Täytä **Tokenin nimi \***, esimerkiksi "Warehouse WMS". Voit halutessasi asettaa **Voimassa (päivää)** ja **Rajaa brändiin**.
  </Step>

  <Step title="Valitse oikeudet">
    Merkitse, mitä token saa tehdä, tai napsauta **Valitse kaikki**.
  </Step>

  <Step title="Luo se">
    Napsauta **Luo token**. Näet viestin **API-token luotu**, ja **API-token luotu** -ikkuna avautuu koko tokenin kanssa.
  </Step>
</Steps>

<Frame caption="Luo API-token: nimi, valinnainen vanheneminen ja sitten oikeudet">
  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/02-create-modal-light.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=a351e1792dadc76678d0325b075623f4" alt="Luo API-token -ikkuna, jossa Tokenin nimi, Voimassa (päivää) ja oikeuksien valintaruudut" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/create-an-api-token/02-create-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/02-create-modal-dark.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=e07c0f3e133ed838442b1f7f321c02e8" alt="Luo API-token -ikkuna, jossa Tokenin nimi, Voimassa (päivää) ja oikeuksien valintaruudut" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/create-an-api-token/02-create-modal-dark.png" />
</Frame>

| Kenttä | Pakollinen | Mitä kirjoittaa |
| - | - | - |
| **Tokenin nimi \*** | Kyllä | Nimi, joka kertoo, missä tokenia käytetään, kuten "Production API" tai "Webhook Service". Enintään 100 merkkiä. |
| **Rajaa brändiin** | Ei | Näkyy vain, jos organisaatiollasi on [brändejä](/docs/fi/how-to/create-a-brand). Valitse brändi, jolloin **Tätä tokenia käyttävät sovellukset ja järjestelmät näkevät ja voivat muuttaa vain tämän brändin tietoja.** Oletus on **Ei brändiä (koko organisaatio)**. Tätä ei voi muuttaa myöhemmin. |
| **Voimassa (päivää)** | Ei | Luku väliltä 1-365. Token lakkaa toimimasta, kun näin monta päivää on kulunut. Jätä tyhjäksi, jos haluat tokenin, joka ei vanhene. |
| **Oikeudet \*** | Kyllä, vähintään yksi | Mitä token saa lukea ja muuttaa. Katso alla oleva luettelo. |

**Luo token** pysyy harmaana, kunnes tokenilla on nimi ja vähintään yksi oikeus.

### Oikeudet

Jokaisella alueella on **Luku**-oikeus (**Tietojen katselu ja lukeminen**) ja **Kirjoitus**-oikeus (**Luonti, muokkaus ja poisto**). **Kirjoitus**-oikeus sisältää **Luku**-oikeuden samalle alueelle.

<Frame caption="Kaikki oikeudet, Valitse kaikki käytössä">
  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/03-permissions-light.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=79a18be70084170411efa924c84dbbd6" alt="Luo API-token -ikkunan oikeudet Luku- ja Kirjoitus-valintaruuduilla, mukaan lukien Kaikkien tietojen katselu ja Kaikkien tietojen muokkaus" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/create-an-api-token/03-permissions-light.png" />

  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/03-permissions-dark.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=42d3cceb834d25c54cae0da7762985fd" alt="Luo API-token -ikkunan oikeudet Luku- ja Kirjoitus-valintaruuduilla, mukaan lukien Kaikkien tietojen katselu ja Kaikkien tietojen muokkaus" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/create-an-api-token/03-permissions-dark.png" />
</Frame>

| Oikeus | Kattaa |
| - | - |
| **Lähetysten katselu** / **Lähetysten muokkaus** | Lähetykset |
| **Toimitussääntöjen katselu** / **Toimitussääntöjen muokkaus** | Toimitussäännöt ja [toimitushinnat](/docs/fi/how-to/shipping-quotes) |
| **Kuljetusyhtiöiden katselu** / **Kuljetusyhtiöiden muokkaus** | Yhdistetyt kuljetusyhtiöt |
| **Osoitteiden katselu** / **Osoitteiden muokkaus** | Lähettäjän osoitteet |
| **Organisaation katselu** / **Organisaation muokkaus** | Organisaatiosi tiedot |
| **Tiimin jäsenten katselu** / **Tiimin jäsenten muokkaus** | Tiimin jäsenet |
| **API-tokenien katselu** / **API-tokenien muokkaus** | Muut API-tokenit |
| **Kaikkien tietojen katselu** / **Kaikkien tietojen muokkaus** | Kaikki yllä oleva paitsi API-tokenit sekä tilaukset, myyntikanavat, tulostimet, webhookit, automaatiot, integraatiot ja roolit |

Tilauksilla, myyntikanavilla, tulostimilla, webhookeilla, automaatioilla ja integraatioilla ei ole omaa oikeutta: tokenilla, joka tarvitsee niitä, on oltava **Kaikkien tietojen katselu** tai **Kaikkien tietojen muokkaus**. Kumpikaan niistä ei sisällä API-tokeneita, joten merkitse myös **API-tokenien muokkaus**, jos tokenin on luotava tai poistettava muita tokeneita. Samoja oikeuksia käytetään [mukautetuissa rooleissa](/docs/fi/how-to/roles-and-permissions).

## Kopioi token (kerran)

**API-token luotu** näyttää koko tokenin, joka alkaa `zipp_`. Ikkuna varoittaa: **Muista kopioida tämä token. Et näe sitä enää, kun suljet tämän ikkunan.**

<Frame caption="API-token luotu: kopioi token ennen kuin suljet ikkunan">
  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/04-token-secret-light.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=2357355aeb6eecd96f0401f80f3eb086" alt="API-token luotu -ikkuna, jossa token, Kopioi-painike ja Tärkeää-varoitus" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/create-an-api-token/04-token-secret-light.png" />

  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/04-token-secret-dark.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=d0686992013fd38b74fd6239e5f7e100" alt="API-token luotu -ikkuna, jossa token, Kopioi-painike ja Tärkeää-varoitus" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/create-an-api-token/04-token-secret-dark.png" />
</Frame>

Napsauta **Kopioi**. Näet viestin **Token kopioitu leikepöydälle**. Jos näet viestin **Tokenin kopioiminen epäonnistui**, valitse token ja kopioi se käsin. Sulje sitten ikkuna. Jos menetät tokenin, poista se ja luo uusi.

<Warning>
  Kohtele tokenia kuin salasanaa. Älä laita sitä koodiin, jonka muut näkevät, tai verkkosivulle. Jos se vuotaa, poista se (katso alla "Poista token") ja luo uusi. Epäonnistuvat pyynnöt: [API-tokenin todennusvirheet](/docs/fi/knowledge-base/api-token-authentication-errors).
</Warning>

## Käytä tokenia

Kehittäjäsi lähettää tokenin jokaisen pyynnön mukana:

```bash theme={null}
curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"
```

`{orgId}` on organisaatiosi ID, ei sovelluksen osoiterivillä näkyvä nimi. Kehittäjä voi luetella sen API-viitteen Orgs-pyynnöillä, [API-viitteessä](/docs/api-reference/overview), jossa jokainen pyyntö ja vastaus on kuvattu. Valmiit asiakasohjelmistot: [SDK:t](/docs/fi/sdks/overview). Rajat: [Käyttörajat](/docs/api-reference/rate-limits).

Token ilman brändiä voi kohdistaa yksittäisen pyynnön yhteen brändiin `X-Zippendo-Brand`-otsakkeella. Token, joka luotiin kohdalla **Rajaa brändiin**, pysyy aina brändinsä sisällä. Katso [Brändit](/docs/fi/settings/brands).

## Poista token

Napsauta **Poista** tokenin rivillä. **Poista API-token** pyytää kirjoittamaan tokenin nimen isoilla kirjaimilla, esimerkiksi `WAREHOUSE WMS`, ja napsauttamaan sitten **Poista**. Näet viestin **API-token poistettu**. Mikään tokenia käyttävä järjestelmä ei enää pysty yhdistämään. Poistoa ei voi perua, eikä tokenia voi sen sijaan keskeyttää.

<Frame caption="Poista API-token: vahvista kirjoittamalla nimi isoilla kirjaimilla">
  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/05-delete-token-light.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=8122dab7c920f84bc037325afe30b296" alt="Poista API-token -ikkuna, jossa kenttä nimen kirjoittamista varten vahvistukseksi" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/create-an-api-token/05-delete-token-light.png" />

  <img src="https://mintcdn.com/zippendo/y4yerikcvzGeoRXb/images/fi/how-to/create-an-api-token/05-delete-token-dark.png?fit=max&auto=format&n=y4yerikcvzGeoRXb&q=85&s=81c8b87508764323f7edec815159b3b9" alt="Poista API-token -ikkuna, jossa kenttä nimen kirjoittamista varten vahvistukseksi" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/create-an-api-token/05-delete-token-dark.png" />
</Frame>

## Liittyvää

* [Webhookit](/docs/fi/how-to/webhooks): Zippendo kertoo järjestelmällesi, kun jotain tapahtuu, sen sijaan että järjestelmäsi kysyisi.
* [Yhdistä Slack, Klaviyo ja muut sovellukset](/docs/fi/how-to/connect-an-integration): valmiit yhteydet, jotka eivät tarvitse API-tokenia.
* [Mukautetun kanavan API](/docs/fi/how-to/custom-channel-api): lähetä tilaukset omasta kaupastasi tai järjestelmästäsi Zippendoon.
* [Hae toimitushinta](/docs/fi/how-to/shipping-quotes): toimitushinnat kassalla.
* [MCP-todennus](/docs/fi/mcp/authentication): yhdistä tekoälyagentti ilman tokenin liittämistä.


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