> ## 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-tokenin todennusvirheet

> Mitä tehdä, kun Zippendo API:n kutsut API-tokenilla hylätään vastauksella 401 Unauthorized, 403 Forbidden tai 429 Too Many Requests.

API-token antaa omalle järjestelmällesi tai kehittäjän skriptille mahdollisuuden toimia Zippendon kanssa. Luot tokenit kohdassa **Asetukset** → **API-asetukset** (avaa organisaatiovalikko ja napsauta **Hallitse**). Jos kutsu hylätään, vastaus kertoo syyn.

## Mitä näet

* `401 Unauthorized` ja `Invalid or expired token` tai `Authentication required`.
* `403 Forbidden` ja `Missing required scope` tai **Sinulla ei ole pääsyä tähän organisaatioon.**
* `429 Too Many Requests` ja `API rate limit of … requests per minute reached.`
* Kutsu toimii Zippendo-sovelluksessa mutta epäonnistuu skriptistäsi tai palvelimeltasi.

## 401: tokenia ei hyväksytä

| Viesti | Todennäköinen syy | Mitä tehdä |
| - | - | - |
| `Authentication required` | Tokenia ei lähetetty | Lähetä token `Authorization`-otsakkeessa, kuten alla näytetään |
| `Invalid or expired token` | Token on kirjoitettu väärin, katkennut, poistettu tai vanhentunut | Tarkista token alla kuvatulla tavalla. Jos olet epävarma, luo uusi |
| `Invalid token type` | Lähetettiin jokin muu kuin API-token, esimerkiksi selaimesta kopioitu arvo | Käytä tokenia, joka näytettiin, kun napsautit **Luo token** |

Lähetä token näin, sanalla `Bearer` ja yhdellä välilyönnillä sen edessä:

```bash theme={null}
Authorization: Bearer zipp_YOUR_TOKEN
```

Tarkista, että:

1. Token alkaa `zipp_` ja se kopioitiin kokonaan, ilman välilyöntejä tai rivinvaihtoja lopussa.
2. Token on edelleen olemassa kohdassa **API-asetukset**. Tokenin poistaminen pysäyttää sen heti.
3. Token ei ole vanhentunut. **Vanhenee**-sarake näyttää päivämäärän. Token, joka luotiin ilman kohtaa **Voimassa (päivää)**, ei vanhene koskaan.

Zippendo näyttää tokenin vain kerran, kohdassa **API-token luotu**. Jos sinulla ei enää ole sitä, luo uusi token kohdalla **Lisää API-token** ja poista vanha. Katso [Luo API-token](/docs/fi/how-to/create-an-api-token).

## 403: tokenilla ei ole lupaa tähän

| Viesti | Todennäköinen syy | Mitä tehdä |
| - | - | - |
| `Missing required scope`, jota seuraa oikeuden nimi, kuten `write:shipments` | Token luotiin ilman kyseistä oikeutta | Luo uusi token ja merkitse oikeus kohdassa **Oikeudet \***. **Oikeudet**-sarake näyttää, mitä kukin token voi tehdä |
| **Sinulla ei ole pääsyä tähän organisaatioon.** | Kutsun osoitteessa oleva organisaatio ei ole se, johon token kuuluu | Käytä organisaatiota, jossa token luotiin, tai luo token toisessa organisaatiossa |
| **Tämä ominaisuus ei sisälly nykyiseen pakettiisi. Vaihda pakettia, niin voit käyttää sitä.** | Kutsuttu ominaisuus ei kuulu pakettiisi | Katso [Laskutus ja käyttö](/docs/fi/how-to/billing-and-usage) |

## 429: liikaa kutsuja

Jokainen paketti sallii tietyn määrän API-kutsuja minuutissa:

| Paketti | Kutsuja minuutissa |
| - | - |
| Free | 10 |
| Standard | 60 |
| Growth | 200 |
| Pro | 1 000 |
| Enterprise | 100 000 |

Kun ylität rajan, vastaus on `API rate limit of … requests per minute reached. Please retry in … s.` `Retry-After`-otsake kertoo, kuinka monta sekuntia odottaa. Odota se aika, yritä sitten uudelleen ja hajauta kutsusi. Lisää: [Käyttörajat](/docs/api-reference/rate-limits).

## Et voi luoda toista tokenia

**Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä.** tarkoittaa, että pakettisi API-tokenien määrä on käytetty: 2 Free-paketissa, 5 Standard-paketissa, 10 Growth-paketissa ja ei rajaa Pro- ja Enterprise-paketeissa. Poista token, jota et enää käytä, tai vaihda pakettia.

## Hyvät tavat

* Pidä tokenit palvelimellasi. Älä koskaan laita tokenia verkkokaupan sivulle tai muuhun koodiin, joka ajetaan asiakkaan selaimessa.
* Anna jokaiselle järjestelmälle oma token, jolla on vain tarvittavat oikeudet. Silloin voit poistaa yhden pysäyttämättä muita.

Liittyvää: [REST API -pikaopas](/docs/fi/quickstarts/rest-api), [API-asetukset](/docs/fi/settings/api-settings), [API:n yleiskatsaus](/docs/api-reference/overview).


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