> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Toimintalokit
> Toimintalokit tallentavat jokaisen API:n kautta tehdyn muutoksen TWICE Commercessa — mitä muutettiin, kenen käyttäjän, API-avaimen tai järjestelmän toimesta ja milloin.
## Määritelmä
**Toimintaloki** on muuttumaton tallenne jokaisesta todennetusta API-pyynnöstä, joka on kohdistunut tiliisi. Jokainen rivi vastaa yhtä pyyntöä — sen toimijaa, kutsuttua päätepistettä, kohteena ollutta resurssia ja palautettua vastausta.
Koska jokainen Adminin toiminto kutsuu lopulta samaa API:a kuin integraatiosi, toimintaloki tallentaa ihmisten työn, API-avainten kutsut ja järjestelmätyöt samaan virtaan.
**Auditointilokit** kuuluvat **Standard**-suunnitelmaan (3 kuukauden historia) ja **Enterprise**-suunnitelmaan (36 kuukautta). Katso [suunnitelmat](/docs/fi/twice-commerce-overview).
## Missä toimintalokit näkyvät
Admin käyttää lokista kahta eri nimeä sen mukaan, missä sitä katsot: tilitason näkymä avataan ylänavigaation kohdasta **Tarkastusloki** ja näkymän oma otsikko on **Auditointiloki**, kun taas kohdekohtainen välilehti on jokaisella resurssisivulla **Toimintaloki**.
| Näkymä | Mitä se näyttää |
| :-------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| **Tilitason loki** (ylänavigaatiossa **Tarkastusloki**, otsikoltaan **Auditointiloki**) | Kaikki koko tilin pyynnöt |
| **Varastoartikkeli > Toimintaloki-välilehti** | Pyynnöt, joiden `affectedRecords` sisältää kyseisen varastoartikkelin |
| **SKU > Toimintaloki-välilehti** | Kyseiseen SKU:hun rajatut pyynnöt |
| **Listaus > Toimintaloki-välilehti** | Kyseiseen listaukseen (katalogikohteeseen) kohdistuneet pyynnöt |
| **Asiakas > Toimintaloki-välilehti** | Kyseiseen asiakkaaseen kohdistuneet pyynnöt |
| **Tilaus > Toimintaloki-välilehti** | Kyseiseen tilaukseen kohdistuneet pyynnöt |
Kohdekohtaiset välilehdet käyttävät samaa taulukkokomponenttia kuin tilitason näkymä, esisuodatettuna kohteen tunnisteeseen.
**Miksi loki on API-muotoinen?** Jokainen Adminin toiminto on myös API-kutsu. Kirjaaminen pyyntörajalla tavoittaa kaiken tilaa muuttavan — näppäimistön, API-integraation ja ajastetun työn — samaan paikkaan ilman aukkoja.
## Mitä lokiin kirjataan
Lokimerkintä kirjoitetaan jokaisesta todennetusta pyynnöstä, joka saapuu palvelimelle. Jokainen merkintä tallentaa sekä saapuvan pyynnön että palautetun vastauksen.
| Sarake | Lähde | Kuvaus |
| :----------------- | :---------------- | :------------------------------------------------------------------------------------- |
| **Aikaleima** | Palvelin | Tarkka aika, jolloin pyyntö vastaanotettiin |
| **Toiminto** | HTTP-metodi | `GET` -> Read, `POST` -> Create, `PUT` / `PATCH` -> Update, `DELETE` -> Delete |
| **Resurssityyppi** | Reitin metatiedot | Käsitellyn resurssin tyyppi (Article, Order, Customer ja niin edelleen) |
| **Tietue-ID** | Pyyntö / vastaus | Kohteena olevan tietueen tunniste (linkitetty tietosivulle, jos sellainen on) |
| **Toimija** | Todennustunniste | Käyttäjä (sähköposti), API-avain (nimike) tai järjestelmä (nimi), joka todensi pyynnön |
| **Päätepiste** | Pyynnön URL | Kutsuttu API-polku ilman kyselymerkkijonoa |
| **Tila** | Vastaus | HTTP-tilakoodi väreillä eroteltuna — onnistuminen vai virhe |
### Toimijatyypit
Lokissa esiintyy kolme toimijatyyppiä:
| Toimija | Näkyy muodossa | Huomioita |
| :------------ | :--------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |
| Käyttäjä | `jordan@yourstore.com` | Todennettu käyttäjän JWT:llä — ihmisen toiminto Adminissa |
| API-avain | `API: Mobile app` | Todennettu [API-avaimella](/docs/fi/concepts/integrations/overview) — nimike on se, joka avaimelle annettiin luonnin yhteydessä |
| Järjestelmä | `System: scheduler:daily-pricing-update` | Sisäinen työ, joka toimii asiakkaan puolesta |
| Tunnistamaton | **Jäljittelemätön** | Pyyntö saapui palvelimelle ilman tunnistettua tunnistetta — tutki, älä sivuuta |
### Tunnistetut resurssityypit
Resurssityyppi-sarake näyttää kullekin resurssille selkokielisen nimen. Nimet ovat koodiin kirjoitettuja, joten ne näkyvät englanniksi myös suomenkielisessä Adminissa. Nykyinen joukko on:
Article (varastoartikkeli), Article ledger, Audit log, Auth, Catalog, Change history, Checkout link, Collection, Customer, Event, File, Inventory report, Order, Payment, Payment account, Pricing table, Report, Saved table view, Search, Service location, SKU, Storefront customization, Tag, Tax, Taxonomy, Tenant, Unavailability, Upload URL, User, Variant.
Kun pyyntö kohdistuu resurssityyppiin, jolla on tietosivu (Article, Catalog, Collection, Customer, Order, SKU), Tietue-ID-sarake näytetään linkkinä.
## Suodattimet ja haku
Taulukkoa voi suodattaa palvelimella seuraavien kenttien perusteella:
| Kenttä | Tuetut operaattorit |
| :------------- | :----------------------------------------------------- |
| Aikaleima | `is`, `after`, `on or after`, `before`, `on or before` |
| Toiminto | `is`, `is any of` |
| Resurssityyppi | `equals`, `is any of` |
| Toimija | `equals`, `is any of` (vastaa käyttäjän sähköpostia) |
| Päätepiste | `contains` (osamerkkijonohaku) |
Tietue-ID ei ole suoraan suodatettava sarake — kohdekohtaiset Toimintaloki-välilehdet hoitavat tämän soveltamalla kohdetietuesuodatinta valmiiksi.
Käyttöliittymässä näkyvät suodatinoperaattorit vastaavat sitä, mihin auditointilokien taustajärjestelmä pystyy tehokkaasti vastaamaan — muut operaattorit on tarkoituksella piilotettu sen sijaan, että ne jätettäisiin hiljaisesti huomiotta.
## Muuttumattomuus
Kirjoitettuja lokimerkintöjä ei voi muokata tai poistaa Administa. Toimintaloki on suunniteltu vain lisättäväksi — juuri siksi se kelpaa jälkikäteiseen auditointiin ja poikkeamien selvittelyyn.
## Säilytysaika
Toimintalokin merkinnät tallennetaan BigQueryyn ja näytetään API:n kautta. Säilytysaika riippuu hinnoittelusuunnitelmastasi:
| Suunnitelma | Säilytysaika |
| :---------- | :--------------------------------------- |
| Discover | 7 päivää |
| Build | 30 päivää |
| Advance | 1 vuosi |
| Enterprise | Mukautettu — tyypillisesti rajoittamaton |
Pidempiaikaista arkistointia varten vie loki taulukosta CSV-muodossa (vienti huomioi nykyiset suodattimet) ja säilytä tiedosto omassa tallennustilassasi.
Lue lisää: [TWICEn hinnoittelu](https://www.twicecommerce.com/pricing)
## Kutsurajat
Toimintalokin lukeminen tekee yhden BigQuery-kyselyn sivua kohden. Päätepiste on kutsurajoitettu IP-osoitteittain, asiakkaittain ja globaalisti, jotta kustannukset ja häiritsevät asiakasohjelmat pysyvät kurissa. Käytännössä tämä tarkoittaa:
* Noin 1 pyyntö sekunnissa jatkuvana IP-osoitetta kohden, pienellä purskevaralla
* Noin 2 pyyntöä sekunnissa jatkuvana asiakasta kohden
* Rajan ylittäminen estää kutsujan 5 minuutiksi
Käyttöliittymässä tällä on harvoin merkitystä, mutta se on hyvä tietää, jos skriptaat auditointilokien päätepistettä vasten.
## API-käyttö
Sama data, jonka käyttöliittymä näyttää, on saatavilla API:n kautta.
Sivutus perustuu kursoriin. Rajaa kyselyä yhdistelemällä parametreja `resourceTypes`, `affectedRecords`, `methods`, `userEmails`, `urls` ja `statusCodes` — operaattorit vastaavat yksi yhteen edellä kuvattuja käyttöliittymän suodattimia.
## Toimintaloki vs. tapahtumat
Toimintaloki ja [tapahtumat](/docs/fi/concepts/inventory/events) ovat rinnakkaisia käsitteitä, jotka menevät helposti sekaisin:
| | Toimintaloki | Tapahtumat |
| :------------- | :--------------------------------------- | :-------------------------------------------------------------------------------------------- |
| Mitä | Tilin API-pyynnöt | Tilausten virstanpylväät (varaukset, noudot, palautukset, muistiinpanot) varastoon sidottuina |
| Milloin | Aina historiaa — tallentaa mitä tapahtui | Voi olla menneisyydessä tai ajastettu tulevaisuuteen |
| Lähde | Palvelinpuolen pyyntöloki | Varaston ja tilauksen elinkaari |
| Muokattavissa? | Ei | Osaa attribuuteista voi muokata, kunnes tapahtuma toteutuu |
| Käyttö | Auditointi, vianselvitys, kohdistus | Toiminnan suunnittelu ja aikajanat |
Käytä toimintalokia, kun haluat vastauksen kysymykseen ”kuka muutti tätä ja milloin”. Käytä tapahtumia, kun haluat suunnitella tai esittää, ”mitä tälle varastoartikkelille tapahtuu ajan kuluessa”.
## Kehittäjän viite
Toimintalokit näkyvät API:ssa nimellä `audit-logs`.
Avaa päätepiste API-referenssissä.
## Aiheeseen liittyvää
Varaston puolen aikajana varauksista, noudoista, palautuksista ja muistiinpanoista
API-avaimet ja webhook-tilaukset — molemmat näkyvät toimijoina toimintalokissa
Lähetä tapahtumia TWICEstä omiin järjestelmiisi
Kuka näkee toimintalokin ja millä rajauksilla sitä voi suodattaa