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

# REST API:n pikaopas

> Luo API-token ja tee ensimmäinen kutsu Zippendo-palvelun julkiseen APIin omasta järjestelmästäsi.

REST API:n avulla omat järjestelmäsi voivat työskennellä suoraan Zippendo-palvelun kanssa, joten verkkokauppasi, ERP- tai varastojärjestelmäsi voi luoda lähetyksiä, lukea tilauksia ja hakea osoitekortteja ilman, että kukaan avaa sovellusta. Kaikki julkiset rajapintakutsut on lueteltu API reference -välilehdellä, jossa on leikkikenttä pyyntöjen kokeilemiseen.

## 1. Luo API-token

<Steps>
  <Step title="Avaa API-asetukset">
    Avaa osoitteessa [app.zippendo.com](https://app.zippendo.com) organisaatiovalikko sivupalkin alareunasta, napsauta **Hallitse** ja sitten **API-asetukset**.
  </Step>

  <Step title="Luo token">
    Napsauta **Lisää API-token**, anna sille nimi (esimerkiksi `Production WMS`), valitse tarvittavat **Oikeudet** ja napsauta **Luo token**. Kopioi token heti: se näytetään vain kerran.
  </Step>

  <Step title="Säilytä se turvallisesti">
    API-tokenit alkavat tunnuksella `zipp_`. Käsittele niitä kuin salasanoja: säilytä ne ympäristömuuttujissa, älä koskaan versionhallinnassa.
  </Step>
</Steps>

Oikeuksista, voimassaoloajasta, brändirajauksesta ja tokenien poistamisesta lisää sivulla [API-asetukset](/docs/fi/settings/api-settings).

## 2. Hae organisaatiosi ID

Jokainen rajapintakutsu ottaa organisaatiosi ID:n (`orgId`) polussa. Kysy Zippendo-palvelulta, mihin organisaatioon tokenisi kuuluu:

```bash theme={null}
curl -X POST https://api.zippendo.com/api-tokens/verify \
  -H "Content-Type: application/json" \
  -d '{ "token": "zipp_YOUR_TOKEN" }'
```

Vastauksessa on `orgId` sekä tokenin `scopes` ja `expiresAt`.

## 3. Tee ensimmäinen pyyntö

Lähetä token Bearer-tunnisteena jokaisessa pyynnössä:

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

Korvaa `{orgId}` vaiheen 2 ID:llä. Token tarvitsee tähän kutsuun oikeuden `read:shipments`.

<Warning>
  Älä koskaan laita API-tokeneita koodiin, joka ajetaan selaimessa tai mobiilisovelluksessa. Kutsu Zippendo-palvelua taustajärjestelmästäsi.
</Warning>

<Tip>
  Haluatko tyypitetyn asiakasohjelman? Ilmaiset **[SDK:t](/docs/fi/sdks/overview)** TypeScriptille, Pythonille, PHP:lle, Golle ja Rubylle kattavat jokaisen rajapintakutsun, joten voit ohittaa raa'an HTTP:n.
</Tip>

Jokaisella paketilla on minuuttikohtainen pyyntöbudjetti. Katso [Pyyntörajat](/docs/api-reference/rate-limits).

## 4. Tutustu rajapintakutsuihin

Julkinen API kattaa seuraavat:

| Alue | Tyypillinen käyttö |
| - | - |
| Lähetykset | Luo, lähetä, jaa ja seuraa lähetyksiä, hae osoitekortit ja asiakirjat |
| Tilaukset | Luo tilauksia ja lue myyntikanaviesi tuomat tilaukset |
| Myyntikanavat | Hallitse [mukautettuja kanavia](/docs/fi/order-channels/custom-channels) omalle verkkokaupallesi tai ERP:llesi |
| Kuljetusyhtiöt | Yhdistä kuljetusyhtiöitä, luettele niiden kuljetuspalvelut ja hae noutopisteitä |
| Toimituslaskelma | Toimitussääntöjesi mukaiset hinnat ostoskorille kassalla |
| Toimitussäännöt | Lue ja hallitse toimitussääntöjä |
| Webhookit | Saa ilmoitus, kun lähetykset, tilaukset ja seuranta muuttuvat |
| Osoitteet | Hallitse lähettäjän, noudon ja palautusten osoitteita |

Avaa [API reference](/docs/api-reference/overview) selataksesi polkuja ja pyyntöjen sisältöjä ja kokeillaksesi pyyntöjä leikkikentässä.

## Seuraavat vaiheet

<CardGroup cols={2}>
  <Card title="Webhookien pikaopas" icon="webhook" href="/docs/fi/quickstarts/webhooks">
    Lähetä tapahtumat palvelimellesi, kun tiedot muuttuvat.
  </Card>

  <Card title="Toimituslaskelmat" icon="calculator" href="/docs/fi/quickstarts/shipping-quotes">
    Näytä ostoskorin toimitushinnat kassalla.
  </Card>

  <Card title="MCP-palvelin" icon="bot" href="/docs/fi/mcp/overview">
    Anna Clauden, Cursorin tai ChatGPT:n työskennellä Zippendo-palvelussa puolestasi.
  </Card>

  <Card title="Mukautetut kanavat" icon="plug" href="/docs/fi/order-channels/custom-channels">
    Lähetä tilaukset omasta verkkokaupastasi tai ERP:stäsi Zippendo-palveluun.
  </Card>
</CardGroup>


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