Versions Compared

Version Old Version 7 New Version 8
Changes made by

Josh Luth

Josh Luth

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Genesis Graph API URLs:

Production: https://api.trustwell.com/genesis

Preview: TBD

Development (Internal Only): https://api-dev.trustwell.com/genesis

...

Obtaining your API Key

To start using the Genesis Foods API, you need to -

  • Log into the Genesis Foods application

  • Generate an API Key

    • NOTE: Only Admins with API Access will have the ability to generate an API Key

  • Send the API Key with every request in the header

  • The API has rate and usage limits

  • The API only responds to HTTPS. Any requests sent via HTTP return an HTTP 301 redirect to corresponding HTTPS resources

  • Genesis Foods API is a GraphQL API with a single endpoint. Read more about working with GraphQL API’s here.

Authentication/Authorization

An API Key can be generated in the Genesis Foods application if your user has been given the appropriate permission. Please contact your Account Manager if you don’t see the ability to generate API Keys.

...

Code Block
languagejson
{
  "X-API-KEY": "XXXYYYYBBBBZZZZ"
}

Searching

Searching for foods is a key action that users utilize to build recipes. Search results are paginated.

...

Expand
titleResponse
Code Block
languagejson
"data": {
        "foods": {
            "search": {
                "foodSearchResults": [
                    ...
                    {
                        "id": "423f0ddd-14b2-4114-8323-7f8ccc11ddac",
                        "name": "granola, prepared from recipe",
                        "modified": "2023-03-27T16:57:27.4906008+00:00",
                        "created": "2023-03-27T16:57:27.4838005+00:00",
                        "versionName": "V1",
                        "foodType": "Ingredient",
                        "product": "USDA",
                        "supplier": "USDA SR-Legacy",
                        "isApproved": true,
                        "versionHistoryId": "4b7f32ab-3bae-469d-bce8-2dfd28b726d0"
                    },
                    {
                        "id": "21b52b33-2fde-498e-9a44-5023f98260b4",
                        "name": "taffy, prepared from recipe",
                        "modified": "2023-03-27T18:53:40.3575528+00:00",
                        "created": "2023-03-27T18:53:40.3504859+00:00",
                        "versionName": "V1",
                        "foodType": "Ingredient",
                        "product": "Canadian Nutrient File",
                        "supplier": "Health Canada (Canadian Nutrient File)",
                        "isApproved": true,
                        "versionHistoryId": "fb308722-32c1-45c8-8666-42ba8e0a329c"
                    },
                    {
                        "id": "a7eaee32-6ecd-4ece-90d0-48300d9d4439",
                        "name": "divinity, prepared from recipe",
                        "modified": "2023-03-27T17:44:05.6121672+00:00",
                        "created": "2023-03-27T17:44:05.6036143+00:00",
                        "versionName": "V1",
                        "foodType": "Ingredient",
                        "product": "USDA",
                        "supplier": "USDA SR-Legacy",
                        "isApproved": true,
                        "versionHistoryId": "db00f784-1a0d-4b14-a4cd-dd53b8487475"
                    },
                    ...
                ],
                "totalCount": 1407,
                "pageInfo": {
                    "cursor": 10,
                    "hasNextPage": true,
                    "startCursor": 0,
                    "endCursor": 1407
                }
            }
        }
    }
}

Getting an Analysis

Querying Standard Entities

Creating an Ingredient

Creating a Recipe