Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Ota yhteyttä
Finnish
FI Finnish
US English (US)
  • Koti
  • Partnerit

AI Commerce GraphQL -käyttöohje partnereille

Opi hyödyntämään AI Commercea yhteistyökumppaneidesi kanssa GraphQLin avulla.

Written by Petro Mäntylä

Updated at April 27th, 2026

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • AI Commerce Cloud
    Hallinnan etusivu Asiakkuudet Tilaukset Tilausten hallinta Kategoriat Tarjoustyökalu Tuotteet Konfiguraatiot Moduulit Paikallisasetukset ja verot Arvostelut Etusivu FAQ -työkalu Kuvagalleria Työkalut Kassa Lisätoiminnot Svelte Raportit
  • Akeneo
  • WordPress
  • Builder.io
  • Algolia
  • Google
  • Meta
  • Tuki
  • Tehden
  • Partnerit
    Miksi valita AI Commerce?
  • Microsoft
  • Integraatiot
  • Enrerprise Solutions
  • Yleiset sopimusehdot
  • Agentic Commerce
+ Lisää

Sisällysluettelo

Mikä on GraphQL ja miksi sitä käytetään AICommerce-ympäristössä? Miten GraphQL toimii AI Commerce-ympäristössä? Miten tehdä GraphQL-pyyntö AI Commerceen? 📌 Esimerkki: Haetaan 5 tuotetta (POST-pyyntö) Vaaditut headerit jokaisessa pyynnössä Suosittelemme käyttämään AI Commerce Lambda-ympäristöä GraphQL vs. REST API – Mitä eroa? AI Commerce GraphQL - Rate Limiting Yhteenveto Missä on tarkempi GraphQL API -dokumentaatio?

AI Commerce GraphQL API kumppaneille

Tämä artikkeli kertoo, miten kumppanit ja integraatiotiimit käyttävät AI Commercen GraphQL API:a. Artikkelissa kuvataan, mistä julkinen API-dokumentaatio löytyy, miten pyynnöt lähetetään, mitä headereita tarvitaan ja miten rate limiting toimii.


Julkinen API-dokumentaatio

Julkinen GraphQL-skeeman referenssi on osoitteessa https://docs.aicommerce.cloud. Sen kautta voi selata käytettävissä olevia kyselyitä, mutaatioita, tyyppejä, esimerkkejä ja tarvittavia header-tietoja.

Dokumentaatiosivusto ja varsinainen API-yhteyspiste ovat tarkoituksella eri osoitteissa. Käytä docs.aicommerce.cloud-sivustoa skeeman tarkistamiseen, ja lähetä tuotantopyynnöt osoitteeseen https://api.aicommerce.fi/graphql.


Miten GraphQL-pyynnöt toimivat AI Commercessa

GraphQL-pyynnöt lähetetään HTTP POST -pyyntöinä, joiden runko on JSON-muotoinen. Pyynnön runko sisältää query-kentän ja tarvittaessa variables-kentän.

  • Asiakas pyytää vain ne kentät, joita integraatio tarvitsee.
  • API palauttaa datan samassa rakenteessa kuin GraphQL-kyselyn kenttävalinta.
  • Jokaisessa pyynnössä täytyy olla tarvittavat tenant- ja GraphQL-tunnisteet headereissa.

Vaaditut request headerit

Jokaisessa GraphQL-pyynnössä täytyy olla seuraavat headerit.

Header Kuvaus
Content-Type Arvon täytyy olla application/json.
X-Tenant-ID Onboardingissa annettu tenant-tunniste.
X-Tenant-Secret Onboardingissa annettu tenant-kohtainen salaisuus.
X-GraphQL-Secret Onboardingissa annettu AI Commerce GraphQL -käyttöoikeustunniste.

Esimerkkipyyntö

Seuraava esimerkki hakee pienen sivun tuotteita.

query Products($limit: Int, $offset: Int) {
  products(limit: $limit, offset: $offset) {
    id
    name
    price
  }
}

Esimerkkipyyntö muuttujilla:

curl -X POST https://api.aicommerce.fi/graphql \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: your-tenant-id" \
  -H "X-Tenant-Secret: <your-tenant-secret>" \
  -H "X-GraphQL-Secret: <your-graphql-secret>" \
  --data '{
    "query": "query Products($limit: Int, $offset: Int) { products(limit: $limit, offset: $offset) { id name price } }",
    "variables": {
      "limit": 5,
      "offset": 0
    }
  }'

Esimerkkivastauksen rakenne:

{
  "data": {
    "products": [
      {
        "id": "632",
        "name": "Example product",
        "price": 89.9
      }
    ]
  }
}

Rate limiting ja virheet

Tuotannon GraphQL API:ssa on rate limiting palvelun vakauden suojaamiseksi. Nykyinen raja on 100 pyyntöä / 5 minuuttia / tenant.

  • Jos raja ylittyy, API palauttaa vastauksen 429 Too Many Requests.
  • Jos autentikointi epäonnistuu, tarkista tenant-tunniste, tenant-salaisuus ja GraphQL-käyttöoikeustunniste.
  • Jos pyynnön runko on virheellinen, varmista, että JSON on kelvollinen ja että GraphQL-kysely vastaa julkista skeemaa.
{
  "error": "Too many requests, please try again later."
}

GraphQL verrattuna REST API:in

GraphQL sopii tilanteisiin, joissa integraatio tarvitsee tietyn kenttäjoukon tai haluaa hakea toisiinsa liittyviä tietoja yhdellä pyynnöllä.

Osa-alue GraphQL REST API
Pyyntömalli Asiakas määrittää tarvitsemansa kentät. Yhteyspiste määrittää vastauksen rakenteen.
Datan määrä Vain pyydetyt kentät palautetaan. Vastaus voi sisältää kenttiä, joita integraatio ei tarvitse.
Integraation kulku Yksi kysely voi hakea useita toisiinsa liittyviä kenttiä. Useita yhteyspistekutsuja voidaan tarvita.

Tietoturva ja onboarding

  • Säilytä tenant- ja GraphQL-tunnisteet palvelinpuolella. Älä lisää niitä selaimessa ajettavaan koodiin tai julkisiin repositorioihin.
  • Käytä julkista dokumentaatiota kyselyiden nimien, kenttien, argumenttien ja vastaustyyppien tarkistamiseen ennen toteutusta.
  • API-tunnisteita ja onboardingia koskevissa kysymyksissä ota yhteyttä osoitteeseen info@petrosoft.fi.

Yhteenveto

  • Julkinen GraphQL-dokumentaatio on osoitteessa https://docs.aicommerce.cloud.
  • Tuotannon API-pyynnöt lähetetään osoitteeseen https://api.aicommerce.fi/graphql.
  • Jokainen pyyntö tarvitsee headerit Content-Type, X-Tenant-ID, X-Tenant-Secret ja X-GraphQL-Secret.
  • API:ssa on tenant-kohtainen rate limiting, joten integraatioiden täytyy käsitellä 429 Too Many Requests -vastaukset hallitusti.
tekoäly kauppa

Oliko artikkeli hyödyllinen?

Kyllä
Ei
Anna palautetta tästä artikkelista

Yhteenkuuluvat artikkelit

  • AI Commerce tukee Composable Commercea ja Serverless Lamda -kehitysympäristöä
  • Mikä on AI Commerce ja visiomme?
  • Sonet CGI Premium AI Commerce API
  • AI Commerce tukee erillistä kehitysympäristöä partnereille
  • Miten hallita frontendin haaroja Sveltessä?
AI Commerce Logo

Future-proof eCommerce, built in the EU

AI Commerce Cloud is developed and hosted within the EU, fully compliant with GDPR and all relevant regulations.

Solutions

Service packages Features Integrations Customers

About us

About us Support Vision Contact us

Development

Changelog Blog Implementation Partners System status
AI Commerce Cloud FI0818073-0
Ranta-Tampellan Katu 17, 33180 Tampere, Finland
info@aicommerce.fi
Privacy Policy Licensing Rights Terms of Use
© 2025 AI Commerce Cloud. All rights reserved.
Expand