Get an import preview

GET

/api/v1/recipes/import-previews/{preview_id}

curl --request GET \
  --url http://127.0.0.1:8080/api/v1/recipes/import-previews/example \
  --header 'Authorization: Bearer <token>'

• A local instance on its default listener.

A review can be finished in passes. This returns the preview as it stands, so what was left after an earlier selection was imported can be taken up again.

Authorizations

• bearerToken
• browserSession

Parameters

Path Parameters

preview_id

required

string

Responses

200

The staged preview, with the candidates already imported taken out.

Media typeapplication/json

object

expires_at

required

string format: date-time

id

required

string

items

required

Array<object> | null

object

already_here

required

boolean

analysis

required

object

matches

required

Array<object> | null

object

authors

required

Array<string> | null

entry_id

required

string

evidence

required

string

Allowed values: source-identity canonical-url portable-id similarity

ingredient_count

required

integer format: int64

recipe_id

required

string

revision

required

integer format: int64

>= 1

score

required

number format: double

<= 1

title

required

string

yield

string

key

additional properties

any

status

required

string

Allowed values: new definite-match likely-duplicate ambiguous

key

additional properties

any

assets

required

object

available

required

integer format: int64

deferred

required

integer format: int64

discovered

required

integer format: int64

failed

required

integer format: int64

preview_url

Retrieves this recipe’s leading photograph on demand; answers 404 with a problem type saying whether it is pending or unavailable

string

unavailable

required

integer format: int64

key

additional properties

any

can_commit

required

boolean

diagnostics

required

Array<object> | null

object

area

required

string

class

required

string

Allowed values: blocking actionable informational

code

required

string

count

required

integer format: int64

>= 1

message

required

string

severity

required

string

Allowed values: info warning error

targets

Array<object> | null

object

action

string

evidence

string

field

string

object_id

string

preserved

string

resolution

object

authored_form

required

string

candidate_unit_ids

required

Array<string> | null

id

required

string

kind

required

string

resolution_key

required

string

source_end

required

integer format: int64

source_start

required

integer format: int64

key

additional properties

any

key

additional properties

any

key

additional properties

any

id

required

string

recipe

required

object

description

string

ingredient_count

required

integer format: int64

ingredients

Array<object> | null

object

items

required

Array<string> | null

title

string

key

additional properties

any

instructions

Array<object> | null

object

items

required

Array<string> | null

title

string

key

additional properties

any

step_count

required

integer format: int64

title

required

string

yield

string

key

additional properties

any

source

required

object

attribution

string

can_retain

required

The uploaded original can be retained explicitly when this preview item is committed

boolean

extracted_text

Text extracted from a document upload, editable before commit

string

filename

string

format_id

required

string

format_name

required

string

url

string

key

additional properties

any

key

additional properties

any

preview_revision

required

integer format: int64

>= 1

resolution_decisions

required

Array<object> | null

object

authored_forms

required

Array<string> | null

candidate_unit_ids

required

Array<string> | null

choices

required

Array<object> | null

object

convention

required

string

convention_label

string

label

required

string

magnitude

string

unit_id

required

string

key

additional properties

any

examples

required

Array<object> | null

object

after

string

before

required

string

recipe_title

required

string

source_text

required

string

key

additional properties

any

group_ids

required

Array<string> | null

id

required

string

ingredients

required

integer format: int64

measure_label

required

string

occurrences

required

integer format: int64

>= 1

recipes

required

integer format: int64

>= 1

source_label

string

key

additional properties

any

resolution_groups

required

Array<object> | null

object

authored_form

required

string

candidate_unit_ids

required

Array<string> | null

choices

required

Array<object> | null

object

convention

required

string

convention_label

string

label

required

string

magnitude

string

unit_id

required

string

key

additional properties

any

examples

required

Array<object> | null

object

after

string

before

required

string

recipe_title

required

string

source_text

required

string

key

additional properties

any

id

required

string

ingredients

required

integer format: int64

kind

required

string

Allowed values: unit_alias

occurrences

required

integer format: int64

>= 1

recipes

required

integer format: int64

>= 1

source_label

string

subgroups

required

Array<object> | null

object

occurrences

required

integer format: int64

>= 1

recipes

required

integer format: int64

>= 1

source_text

required

string

key

additional properties

any

key

additional properties

any

resolution_profiles

required

Array<object> | null

object

id

required

string

label

required

string

selects

required

Array<string> | null

unanswered

required

Array<string> | null

unit_registry_version

required

string

key

additional properties

any

key

additional properties

any

Example

{
  "items": [
    {
      "analysis": {
        "matches": [
          {
            "evidence": "source-identity"
          }
        ],
        "status": "new"
      },
      "diagnostics": [
        {
          "class": "blocking",
          "severity": "info"
        }
      ]
    }
  ],
  "resolution_groups": [
    {
      "kind": "unit_alias"
    }
  ]
}

401

No valid session or API token (authentication-required), or the credential sent is invalid (invalid-credentials).

Media typeapplication/problem+json

object

code

required

string

detail

required

string

status

required

integer format: int64

title

required

string

type

required

string

key

additional properties

any

Example^generated

{
  "code": "example",
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Forbidden

Media typeapplication/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

404

Not Found

Media typeapplication/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

409

Conflict

Media typeapplication/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

413

Request Entity Too Large

Media typeapplication/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

422

Unprocessable Entity

Media typeapplication/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

500

Internal Server Error

Media typeapplication/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

503

Service Unavailable

Media typeapplication/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}