ACTIQS FÖR ORGANISATIONER

Samma kunskap. I ditt system.

Ett fungerande läs-API för ingredienser, produktversioner, källor och forskningsmetadata.

API v1 · schema 004 · skyddad förhandsvisning. Exemplen nedan använder sajten och databasens aktuella innehåll. Återförsäljarprodukter finns i retailer-products med deklarationer, strukturerat innehåll och versions-ID. Open Food Facts finns i source-products och källornas rättigheter följer med. products visar fiktiva exempel. Kundåtkomst kräver en befintlig Bearer-nyckel med rätt resursbehörighet. Förhandsvisningen använder ett daterat databassnapshot.

Prova en fråga

Öppna ditt datakonto →

Kund-API:et stöder Bearer-nycklar med åtkomst per resurs och gemensamma minut- och dygnskvoter. Nycklar hanteras lokalt och kan återkallas. Självregistrering och betalning är ännu inte anslutna.

Produktlistorna visar aktuella versioner med lagrade bilder. coverage=structured väljer produkter med en godkänd ingrediensdeklaration; det innebär inte att alla ingredienser är identifierade. Forsknings-API:et visar endast automatiskt granskade underlag. Ogranskade sammanställningar kan visas på forskningssidan med en tydlig notis.

Mängdkombinationer tar 2–6 distinkta produkthash-ID:n i products. Resultatet bevarar exakt decimalsträng, form, källdeklarerad basis, versions-ID, originalbelägg och luckor. Det beräknar varken dagsdos, elementhalt eller kombinationssäkerhet. lang ändrar endast en separat översättning av den egna notisen. Ändrade käll-/review-/identitetsversioner ger 409 selection_changed och kräver en ny läsning.

Uttryckliga mängdval är tre separata GET-resurser med varsin explicit resursbehörighet: retailer-declared-quantity-options tar products med 1–6 distinkta produkthashar; retailer-declared-quantity-resolve tar selections för 1–6 produkter; retailer-selected-amount-combinations tar selections för 2–6 olika produktidentiteter. Standardsummeringen ändras inte och ger ingen automatisk behörighet till dessa resurser. Discovery har inget förval. Ingen kund eller nyckel har fått utökad åtkomst.

selections är en URL-kodad JSON-lista, högst 4 096 tecken, med exakt product_id, product_version_id, recipe_job_id och choice_id per produkt; varje ID är 64 små hex-tecken från options. Hela URL:en får vara högst 8 192 tecken. Duplicerade parametrar eller produkter, extra fält, klientmängd, enhet, basis, cell eller form avvisas. lang stöds inte i dessa tre resurser: originalfälten bevaras. Gammal choice/source/review ger 409 selection_changed och kräver ny discovery. Saknad discoveryprodukt ger 404.

Cellens literal value/unit/basis, source_cell_text, source_row, preceding_rows, column_context, versioner, fingerprints, källänk och blockers följer med. Olika eller tvetydig kolumnkontext, saknad exakt identitet/form/basis och IU kan ge inga totals. Ovalt innehåll anges som outside_explicit_selection. Detta är inget dos- eller portionsförslag. Den lokalt verifierade Carlson-deklarationen har 150 mcg och 6,000 IU i samma cell. Dess senare godkända recept saknas i det daterade Preview-snapshotet, så valreferensen avvisas där. Inga verkliga positiva explicita kombinationssummor eller skilda portionskolumnpar är verifierade.

Privata driftresurser source-quality/status, ingredient-mappings/status och news/review kräver lokal administration och kan inte användas med kundnyckel. Kvalitetsstatus räknar fält i alla lagrade källversioner och visar högst 15 scanfel/flagged fields. Mappningsstatus räknar alla lagrade mappningsrader och visar högst 10 mappningsbeslut. News/review är en aktuell källbunden selection, limit 1–40, default 25, offset 0; meta.total avser bara det begränsade urvalet. Lika prioritet och datum skiljs med event-ID. Aktuellt original, utkast, skrivförsök och exakt avslutad review kontrolleras; en äldre approval blir inte aktuell igen vid retry. publication_current och diagnostic_reason anger bindningsresultatet. Originalfält översätts inte och dessa resurser skapar inga jobb. Endast lang=sv accepteras.

Regulatory-monitor kräver en registrerad provider. id väljer en exakt källpost; scope är ett exakt JSON-par för fält och originalvärde i aktuell post; compare väljer en verifierad version från samma posts historik. Listan tillåter limit 1–50 och offset 0–100 000. Datum och källfält bevaras på originalspråk. Historisk rapportstatus är inget aktuellt återkallelsebesked. Notiser och produktmatchningar är avstängda; råoriginalexport ingår inte i denna resurs.

Ämneskombinationer skiljer shared_source_references och shared_reference_coverage som bibliografi från reported_interactions med separat granskning, evidence_id, source_text_version_id, publication_version_id, hela kandidatpaketet, study_context och originalbelägg. En bibliografisk träff fastställer inte en interaktion. Snapshotbyte ger 409 selection_changed. Alla kundsvar är no-store.

Livsmedel från Livsmedelsverket GET /api/v1/foods?provider=livsmedelsverket&q=mj%C3%B6lk&limit=10
Livsmedel med källans näringskod GET /api/v1/foods?provider=livsmedelsverket&nutrient=ZN&limit=10
Norska livsmedel och näringsvärden GET /api/v1/foods?provider=matvaretabellen&limit=10
Källbundna mängdval för en produkt GET /api/v1/retailer-declared-quantity-options?products=318f27f392a51036dd24aac0c579205f463121f3c2e8ae7fbd374ad0a881be48
Deklarerade mängder från 2–6 produkter GET /api/v1/retailer-amount-combinations?products=20a3137dfe1b02294e919df0a0f5410ee45a1adcc73daf16c2eb581baa558a51,2e0f02db4231f3fd8529e1c725613db0c5ac4a8f56a0bf4f9e4a44d4a71144a3
Sparade regulatoriska källposter GET /api/v1/regulatory-monitor?provider=fsa&limit=10
Återförsäljarprodukter med A och B utan C GET /api/v1/retailer-products?include=chebi-176783,chebi-753867&exclude=chebi-25107&limit=10
Återförsäljarprodukter GET /api/v1/retailer-products?limit=10
Återförsäljare och varumärkessökning GET /api/v1/retailer-products?retailer=vitacost-us&q=magnesium&limit=10
Återförsäljarprodukter med identifierat ämne GET /api/v1/retailer-products?substance=chebi-29073&limit=10
Återförsäljarprodukter med exakt kemisk form GET /api/v1/retailer-products?form=chebi-31794&limit=10
Återförsäljarprodukter med granskad deklaration GET /api/v1/retailer-products?coverage=structured&limit=10
Ingredienskatalog från ämnesregistret GET /api/v1/ingredient-catalogue?limit=10
Ingrediensens strukturerade nätverk GET /api/v1/ingredient-network/chebi-31794
Unika produktidentiteter efter EAN GET /api/v1/product-identities?limit=10
Automatiskt granskade forskningsutdrag för ett ämne GET /api/v1/research-evidence?substance=chebi-29073&limit=10
Gemensamma källreferenser för två ämnen GET /api/v1/substance-combinations?substances=chebi-29073,chebi-17015
Botaniska ingredienser och namn GET /api/v1/botanicals?q=Tongkat%20ali
EU:s livsmedelstillsatser, sök på namn GET /api/v1/external-records?provider=sante-food-additives&q=riboflavin&limit=10
Health Canadas ingredienslistor för ett ämne GET /api/v1/external-records?provider=health-canada-lnhpd&substance=chebi-17015&limit=10
Produkter kopplade till ett ämne GET /api/v1/source-products?substance=chebi-29073&limit=10
Importerade produkter GET /api/v1/source-products?limit=10
Produkter med en källkod GET /api/v1/source-products?tag=en:sugar&limit=10
EFSA:s ämnesposter GET /api/v1/hazards?sheet=SUB&limit=10
EFSA:s toxikologiska referensvärden GET /api/v1/hazards?sheet=FLEX_SUM.ToxRefValues&limit=10
Ämnesregistret GET /api/v1/substances?limit=10
Ämnesregistret i siffror GET /api/v1/substances/status
Publikationer för ett ämne GET /api/v1/substances/chebi-29073/studies?limit=10
Referensexempel · Ingredienser GET /api/v1/ingredients?limit=10
Referensexempel · Ingrediens med former och källa GET /api/v1/ingredients/magnesium
Referensexempel · Produkter med magnesium, utan zink GET /api/v1/products?include=magnesium&exclude=zink
Referensexempel · Alla receptversioner GET /api/v1/products/mineral-duo/formulations
Referensexempel · Källbelagda relationer GET /api/v1/interactions?ingredients=magnesium,zink
Publikationer GET /api/v1/studies?ingredient=magnesium
Källregister GET /api/v1/sources
Dataförändringar GET /api/v1/changes

Ett konsekvent svar

 {
  "data": [
    {
      "id": "magnesium",
      "name_sv": "Magnesium",
      "source_id": "ods-magnesium"
    }
  ],
  "meta": {
    "api_version": "v1",
    "schema_version": "004",
    "total": 12,
    "limit": 25,
    "offset": 0,
    "next_offset": null
  }
} 

Förkortat svarsexempel. Faktiska svar innehåller ytterligare fält och en tidsstämpel.