Mikä on GraphQL ja miksi sitä käytetään AICommerce-ympäristössä?

GraphQL on joustava ja tehokas rajapintaratkaisu, joka mahdollistaa tarkasti räätälöityjen tietokantakyselyiden tekemisen. Toisin kuin perinteinen REST API, GraphQL antaa kumppaneille vapauden määritellä, mitä dataa he tarvitsevat, mikä vähentää turhaa tiedonsiirtoa ja nopeuttaa pyyntöjen käsittelyä.

Miten GraphQL toimii AI Commerce-ympäristössä?

AI Commerce käyttää Apollo GraphQL-palvelinta, joka vastaanottaa pyyntöjä ja palauttaa vain pyydetyn datan. Partnerit voivat käyttää GraphQL:ää hakemaan tuotteita, maita ja muita tietoja AI Commerce-alustalta.

GraphQL-pyynnöt tehdään HTTP POST -pyyntönä, ja jokaisessa pyynnössä on tarvittavat tunnistetiedot header-kentässä.

Miten tehdä GraphQL-pyyntö AI Commerceen?

GraphQL-pyynnöt tehdään JSON-muodossa käyttäen kuormanjakajan osoitetta, joka saadaan ympäristömuuttujasta APP_LOAD_BALANCER_URL.

📌 Esimerkki: Haetaan 5 tuotetta (POST-pyyntö)

{
  "query": "{
    products(limit: 5, offset: 0) {
      id
      name
      price
    }
  }"
}

🔗 Postman / Curl-esimerkki

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

✅ Pyyntö palauttaa seuraavan JSON-vastauksen:

{
  "data": {
    "products": [
      { "id": "632", "name": "721H", "price": 89.9 },
      { "id": "637", "name": "TC7092", "price": 49.9 },
      { "id": "697", "name": "JERONE50EUR", "price": 50 },
      { "id": "698", "name": "JERONE100EU", "price": 100 },
      { "id": "699", "name": "JERONE200EU", "price": 200 }
    ]
  }
}

Vaaditut headerit jokaisessa pyynnössä

Jokainen GraphQL-pyyntö vaatii seuraavat headerit:

Suosittelemme käyttämään AI Commerce Lambda-ympäristöä

AI Commerce suosittelee Lambda-ympäristössä käyttämään aina kuormanjakajan osoitetta, joka löytyy ympäristömuuttujasta:

APP_LOAD_BALANCER_URL

✅ Tällä tavoin pysytään AI Commerce:n sisäverkossa, mikä nopeuttaa pyyntöjen käsittelyä ja parantaa tietoturvaa.

GraphQL vs. REST API – Mitä eroa?

✅ GraphQL mahdollistaa yksilöllisten tietokantakyselyiden kehittämisen partnereiden kanssa.

AI Commerce GraphQL - Rate Limiting

GraphQL-palvelimemme rajoittaa pyyntöjen määrän, jotta vältetään ylikuormitus. Käytössä on rate limiting:

• Maksimi 100 pyyntöä / 5 minuuttia per tenant
• Jos raja ylittyy, palautetaan 429 Too Many Requests

✅ Rate Limitingin hallinta:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "error": "Too many requests, please try again later."
}

✅ Korjaa virheet ja yritä uudelleen!

Yhteenveto

• GraphQL on tehokas ja joustava tapa hakea tietoa AI Commerce-alustasta.
• Pyyntöihin tarvitaan oikeat headerit (X-Tenant-ID, X-Tenant-Secret, X-GraphQL-Secret).
• Käytä aina AI Commerce:n Lambda-kuormanjakajaa (APP_LOAD_BALANCER_URL) tietoturvan parantamiseksi.
• Rate limiting suojaa palvelua ja rajoittaa pyyntöjen määrän.
• Virheiden hallinta on tärkeää → Tutki virhekoodit ja korjaa pyynnöt.

Missä on tarkempi GraphQL API -dokumentaatio?

Tämä artikkeli on yleinen opas, mutta AI Commerce tarjoaa erillisen GraphQL API -dokumentaation, jossa on tarkemmat kyselyformaatit ja lisäominaisuudet.

📩 Ota yhteyttä: info@petrosoft.fi saadaksesi täyden API-dokumentaation!

🚀 Nyt olet valmis käyttämään AICommerce GraphQL:ää tehokkaasti! 🚀