Kanoninen v1-sopimus
Price Comparen OpenAPI-sopimus on generoitujen SDK-metodien, pyyntö- ja vastausmallien, virheiden sekä esimerkkien lähde. SDK-asiakas käyttää tuotannon v1-osoitetta ja palvelinpuolen Bearer-API-avainta.
Katalogi- ja vertailuoperaatiot
Ratkaise normalisoitu tuotetunniste searchProducts-metodilla, tee kahden–neljän tuotteen päätösvertailu compareProducts-metodilla, lue nykyiset toimitetut tarjoukset getProductComparison-metodilla ja hae kooste- tai kauppakohtainen hintahistoria getProductPriceHistory-metodilla.
Hintavahtioperaatiot
Listaa, luo, päivitä ja poista hintavahteja vakaalla X-Price-Compare-Client-Id-otsakkeella. Vahti kuuluu kyseiselle asiakastunnisteelle ja voi lähettää sähköposti-ilmoituksen määritetyssä tavoitehinnassa.
Virheet ja uudelleenyritykset
Validoi syötteet ennen lähetystä. Yritä tilapäisiä 429- ja 5xx-vastauksia uudelleen Retry-After-otsakkeen ja SDK:n retry-käytännön mukaan; älä yritä tunnistautumis-, validointi- tai not-found-virhettä uudelleen muuttamatta pyyntöä.