Avalikud tooteandmed ja API

Avaldatud analüüsid on loetavad nii inimesele kui ka tarkvarale. Andmevaade uueneb automaatselt samast kinnitatud sisust, mida näeb tootelehel. Kasutamiseks pole vaja kontot ega API-võtit.

OpenAPI kirjeldus · Andmevaate lähtepunkt · English guide

Leia täpne mudel ja variant

  1. Otsi mudelinime või täpse müügikoodi järgi. Indeks tagastab avaldatud analüüsid; tühja tulemust ei tohi tõlgendada toote hinnanguna.
  2. Ava tulemuse data_url. Võrdle mudelit, turgu, mälu, ekraanisuurust, põlvkonda ja komplekti. Sama tootepere eri variandid ei ole automaatselt samaväärsed.
  3. Variandi valimiseks kasuta selle toote variants-loendist saadud tunnust. Kontrolli ka järelduse variant_id, applies_to_selected_variant ja scope välju. Variandi valik ei muuda teise variandi testi sellele kohaldatavaks.
https://tootekriitika.ee/andmed/v1/et/tooted.json?q=MN893SO%2FA

Näide leiab Apple TV täpse müügikoodi järgi. Vastuse matched_variant_ids näitab sobivat varianti; data_url viib mudeli andmeteni. Nimelise otsingu näide:

https://tootekriitika.ee/andmed/v1/et/tooted.json?q=OnePlus%20Nord%205
https://tootekriitika.ee/andmed/v1/et/toode/oneplus-nord-5.json
https://tootekriitika.ee/andmed/v1/ru/toode/oneplus-nord-5.json

Mida järeldus tähendab?

  • polarity eristab plussi, miinust ja neutraalset piirangut. confidence näitab tõendite kindlust, mitte toote hinnet.
  • evidence_basis eristab tootja lubadust, fakti, üksikut testi, mitut testi ja piiratud või vastuolulisi tõendeid. Tootja lubadust ei tohi esitada sõltumatu mõõtmisena.
  • Säilita kokkuvõttes scope ja olulised vastutõendid. Testitud tarkvara, piirkond ning tingimused võivad erineda ostja seadmest.
  • Omanike teated ei ole esinduslik valim. Kommentaaride või leitud kaebuste arvust ei saa tuletada rikete protsenti. Uuringu piiratud katvus ei tõesta probleemide puudumist.

Tootekriitika koondab ja analüüsib teiste allikate infot; me ei ole neid seadmeid ise füüsiliselt testinud. Detailne kaalumisreegel on metoodika lehel.

Metoodika ja piirangud

Viita konkreetsele analüüsile

Vastuses lugejale kasuta toote canonical_url aadressi või konkreetse järelduse url-välja, mis avab sama punkti allikad. Ära suuna lugejat toore JSON-i juurde, kui ta tahab toote kohta lugeda.

Erista Tootekriitika koostatud kokkuvõte ja algallika tehtud mõõtmine või omaniku teade. Olulise väite juures säilita algallika viide, kontrollikuupäev ja piirang. Viide peab toetama just seda väidet.

publication.version ja content_updated_at kirjeldavad avaliku analüüsi versiooni; conclusion.verified_at ning allika checked_at kirjeldavad sisukontrolli aega. Serverist pärimise hetk ei ole uus sisukontroll.

Keeled, uuendused ja mõistlik kasutus

ET on faktide lähteversioon. RU andmevaade väljastab ainult kehtiva kinnitatud tõlke. Peamised järeldused vastavad valitud keelele; text-objekti language näitab konkreetse taustavälja keelt. Mudelikoodid, viited ja algallikate nimed võivad jääda muutmata.

Indeksis on category, q, page ja per_page. Lehe suurus on kuni 50, vaikimisi 25; jätka next-aadressilt kuni selle väärtus on null. Kategooriate tunnused on andmevaate lähtepunktis.

Salvesta ETag koos täpse päringu aadressiga ja saada korduspäringus If-None-Match. ET, RU ja eri variantide vahemälu tuleb hoida eraldi. Iga korduskasutus nõuab kehtivuse kontrolli; 304 lubab kasutada sama aadressi varasemat vastust.

400 tähendab vigast parameetrit, 404 puuduvat või mitteavalikku analüüsi või vale varianti, 409 aegunud RU tõlget ja 503 puudulikku vajalikku tõlkevälja. Ära asenda puuduvat RU sisu vaikimisi teise keelega: kasuta märgistatud ET linki. 429 puhul oota Retry-After järgi.

Liides on ainult lugemiseks ja rakendab päringupiirangut, praegu ligikaudu 240 päringut minutis ühe IP kohta. Päri vajaduse järgi, liigu järjest ja kasuta tingimuslikke päringuid. Toorandmete indekseerimiskeeld ei keela andmevaate lugemist; otsingu maandumislehed on inimloetavad analüüsid.

Andmevaade ei anna õigust taaspublitseerida algallikate täistekste ega pilte. Mahuka andmekoopia, andmelitsentsi või püsiva integratsiooni sooviga kirjuta support@tootekriitika.ee. Andmete kasutamine ei taga, et otsingumootor või AI vastuses Tootekriitikat viitab.

Praktilised ühilduvusülevaated

English: data access and citation

Read approved product analyses

Tootekriitika is an Estonian, source-based purchase decision aid for checking an already selected product. It synthesises strengths, weaknesses, limitations and owner reports. We have not physically tested these devices ourselves. This read-only API is generated automatically from the same approved releases shown on the public pages. No account, API key or AI provider is required.

OpenAPI specification · Service description and category identifiers

  1. Find a model or exact retail code using q in the ET or RU product index. Follow next for pagination; per_page is 1–50, default 25. No result means no matching published analysis, not a verdict on the product.
  2. Follow the returned data_url. Match the exact model, region, configuration, screen size, generation and bundle. Exact-code results can include matched_variant_ids.
  3. For a specific variant, pass a variant id returned in that product’s variants list. Read each conclusion’s variant_id, applies_to_selected_variant and written scope. Selecting a variant never makes findings about another variant applicable.
https://tootekriitika.ee/andmed/v1/et/tooted.json?q=MN893SO%2FA
https://tootekriitika.ee/andmed/v1/et/toode/oneplus-nord-5.json
https://tootekriitika.ee/andmed/v1/ru/toode/oneplus-nord-5.json

Preserve evidence and cite the human page

polarity means positive, negative or neutral; confidence is evidence strength, never a product rating. evidence_basis distinguishes manufacturer promises, direct facts, tests and limited or conflicting evidence. Preserve scope, software version, region, test conditions and counterevidence. Owner reports are not a representative sample and cannot establish failure rates. Limited research does not prove an absence of problems.

Link readers to canonical_url or a conclusion’s url, which opens that point’s evidence on the human page. Distinguish Tootekriitika’s synthesis from the original test, manufacturer statement or owner’s report. Include the original source where it supports the claim, together with important limitations. publication.content_updated_at and version describe the public release; conclusion.verified_at and source.checked_at describe editorial verification. Retrieval time is not a new fact check.

Languages, caching and errors

ET is the factual source. RU is served only when its approved translation is current. Main conclusion titles, summaries and scopes match the requested locale. Descriptive text objects include their own language field. Do not silently replace unavailable RU content with ET: label the fallback link. Source names, retail codes and URLs may stay unchanged.

Keep caches separate by the full URL, locale and variant. Store ETag and revalidate with If-None-Match before reuse; 304 permits reuse of that exact representation. A 400 is an invalid parameter; 404 is missing or non-public content or a foreign variant; 409 is an outdated RU translation; 503 is an incomplete required translation. At 429, wait as instructed by Retry-After. The approximate shared per-IP limit is currently 240 requests per minute. Fetch sequentially and only when needed. GET and HEAD are supported; writes are rejected.

Raw JSON is noindex; human analysis pages are the search landing pages. Access does not license full reproduction of third-party source texts or images. For bulk data copies, licensing or a sustained integration, contact support@tootekriitika.ee. Technical accessibility cannot guarantee that a search or AI service will use or cite this site.