Files
openfoodnetwork/engines/dfc_provider
Maikel 400d087789 Merge pull request #11133 from mkllnk/dfc-api-specs
OFN DFC API documenation in OpenAPI format generated with Rswag
2023-07-03 10:53:40 +10:00
..
2023-06-19 16:19:48 +10:00
2020-05-06 22:04:56 +02:00
2023-05-09 16:51:25 +10:00
2023-05-09 16:51:25 +10:00

Data Food Consortium API for the Open Food Network app (OFN DFC API)

This engine implements the Data Food Consortium specifications. It serves and reads semantic data encoded in JSON-LD.

Authentication

The DFC uses OpenID Connect (OIDC) to authenticate requests. You need an account with a trusted OIDC provider. Currently these are:

But you can also authenticate with your OFN user login (session cookie) through your browser.

And you can also use your OFN API token in the HTTP header. For example:

X-Api-Token: d6ccf8685b8cd29b67ae6186e9ceb423bd2ac30b7c880223

API endpoints

The API is under development and this list may be out of date.

/api/dfc-v1.7/persons/:id
 * show: firstName, lastName, affiliatedOrganizations

/api/dfc-v1.7/enterprises/:id
 * show: name, suppliedProducts, catalogItems

/api/dfc-v1.7/enterprises/:enterprise_id/supplied_products (index)

/api/dfc-v1.7/enterprises/:enterprise_id/supplied_products/:id
 * create: name, description, quantity
 * show: name, description, productType, quantity
 * update: description

/api/dfc-v1.7/enterprises/:enterprise_id/catalog_items (index)

/api/dfc-v1.7/enterprises/:enterprise_id/catalog_items/:id
 * show: product, sku, stockLimitation, offers (price, stockLimitation)
 * update: sku, stockLimitation