Issue a native resource observer ticket

Private admission command carrying the current native READ capability for one scheduled preorder, reservation, waitlist entry or QR table session. The native owner verifies the exact resource and actual browser Origin before issuing an observer ticket; account and device credentials supply no authority.

kindRequired

Native resource family with implemented observer admission, authorized by the submitted current READ capability. Scheduled preorder, reservation, waitlist and table session sources are each verified by their owning domain.

allOf

Full definition

{
  "description": "Native resource family with implemented observer admission, authorized by the submitted current READ capability. Scheduled preorder, reservation, waitlist and table session sources are each verified by their owning domain.",
  "allOf": [
    {
      "$ref": "#/components/schemas/PublicObserverTicketResourceKind"
    }
  ],
  "example": "PREORDER"
}

resourceIdRequired

Exact native preorder fulfillment, reservation, waitlist entry or table session UUID. The current capability must own this resource.

string · uuid

Full definition

{
  "type": "string",
  "format": "uuid",
  "description": "Exact native preorder fulfillment, reservation, waitlist entry or table session UUID. The current capability must own this resource.",
  "example": "d5b5eb29-9b8d-4d6f-8f4f-6f0e58f32568"
}

capabilityRequired

Private current native READ capability for the selected resource. Submit directly in this command body; keep it outside URLs, Redux, logs and browser account authentication.

string

Full definition

{
  "type": "string",
  "minLength": 20,
  "maxLength": 1024,
  "writeOnly": true,
  "description": "Private current native READ capability for the selected resource. Submit directly in this command body; keep it outside URLs, Redux, logs and browser account authentication.",
  "example": "https://example.test/resource"
}

{
  "type": "object",
  "properties": {
    "kind": {
      "description": "Native resource family with implemented observer admission, authorized by the submitted current READ capability. Scheduled preorder, reservation, waitlist and table session sources are each verified by their owning domain.",
      "allOf": [
        {
          "$ref": "#/components/schemas/PublicObserverTicketResourceKind"
        }
      ],
      "example": "PREORDER"
    },
    "resourceId": {
      "type": "string",
      "format": "uuid",
      "description": "Exact native preorder fulfillment, reservation, waitlist entry or table session UUID. The current capability must own this resource.",
      "example": "d5b5eb29-9b8d-4d6f-8f4f-6f0e58f32568"
    },
    "capability": {
      "type": "string",
      "minLength": 20,
      "maxLength": 1024,
      "writeOnly": true,
      "description": "Private current native READ capability for the selected resource. Submit directly in this command body; keep it outside URLs, Redux, logs and browser account authentication.",
      "example": "https://example.test/resource"
    }
  },
  "description": "Private admission command carrying the current native READ capability for one scheduled preorder, reservation, waitlist entry or QR table session. The native owner verifies the exact resource and actual browser Origin before issuing an observer ticket; account and device credentials supply no authority.",
  "required": [
    "kind",
    "resourceId",
    "capability"
  ],
  "example": {
    "kind": "PREORDER",
    "resourceId": "d5b5eb29-9b8d-4d6f-8f4f-6f0e58f32568",
    "capability": "https://example.test/resource"
  }
}

Native resource family with implemented observer admission, authorized by the submitted current READ capability. Scheduled preorder, reservation, waitlist and table session sources are each verified by their owning domain.

{
  "type": "string",
  "enum": [
    "PREORDER",
    "RESERVATION",
    "WAITLIST",
    "TABLE_SESSION"
  ],
  "description": "Native resource family with implemented observer admission, authorized by the submitted current READ capability. Scheduled preorder, reservation, waitlist and table session sources are each verified by their owning domain.",
  "example": "PREORDER"
}

Private receipt for one origin-bound, one-use native resource observer upgrade. The database deadline limits ticket admission, while any live resource lease remains bounded by current native and presentation authority. The scope binding identifies a noncredential session namespace.

ticketRequired

Private one-use upgrade ticket. Offer it as a separate WebSocket subprotocol alongside hallify.socket.v1; the server returns only the stable protocol. Keep this value in memory and outside URLs, cookies and Redux.

string

Full definition

{
  "type": "string",
  "minLength": 49,
  "maxLength": 49,
  "pattern": "^gpot1_[A-Za-z0-9_-]{43}$",
  "example": "gpot1_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  "description": "Private one-use upgrade ticket. Offer it as a separate WebSocket subprotocol alongside hallify.socket.v1; the server returns only the stable protocol. Keep this value in memory and outside URLs, cookies and Redux."
}

expiresAtRequired

Database-issued admission deadline, at most thirty seconds and no later than the currently authorized native and presentation deadlines. This is not a live lease expiry.

string · date-time

Full definition

{
  "type": "string",
  "format": "date-time",
  "description": "Database-issued admission deadline, at most thirty seconds and no later than the currently authorized native and presentation deadlines. This is not a live lease expiry.",
  "example": "2026-12-31T18:00:00.000Z"
}

scopeBindingRequired

Noncredential resource-authority binding for the Socket session scope. Append a colon and a nonempty client context of at most 128 characters; current native admission is still required.

string

Full definition

{
  "type": "string",
  "minLength": 49,
  "maxLength": 49,
  "pattern": "^gpos1_[A-Za-z0-9_-]{43}$",
  "example": "gpos1_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  "description": "Noncredential resource-authority binding for the Socket session scope. Append a colon and a nonempty client context of at most 128 characters; current native admission is still required."
}

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "string",
      "minLength": 49,
      "maxLength": 49,
      "pattern": "^gpot1_[A-Za-z0-9_-]{43}$",
      "example": "gpot1_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
      "description": "Private one-use upgrade ticket. Offer it as a separate WebSocket subprotocol alongside hallify.socket.v1; the server returns only the stable protocol. Keep this value in memory and outside URLs, cookies and Redux."
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "description": "Database-issued admission deadline, at most thirty seconds and no later than the currently authorized native and presentation deadlines. This is not a live lease expiry.",
      "example": "2026-12-31T18:00:00.000Z"
    },
    "scopeBinding": {
      "type": "string",
      "minLength": 49,
      "maxLength": 49,
      "pattern": "^gpos1_[A-Za-z0-9_-]{43}$",
      "example": "gpos1_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
      "description": "Noncredential resource-authority binding for the Socket session scope. Append a colon and a nonempty client context of at most 128 characters; current native admission is still required."
    }
  },
  "description": "Private receipt for one origin-bound, one-use native resource observer upgrade. The database deadline limits ticket admission, while any live resource lease remains bounded by current native and presentation authority. The scope binding identifies a noncredential session namespace.",
  "required": [
    "ticket",
    "expiresAt",
    "scopeBinding"
  ],
  "example": {
    "ticket": "gpot1_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "expiresAt": "2026-12-31T18:00:00.000Z",
    "scopeBinding": "gpos1_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
  }
}

Stable error envelope emitted by the global HTTP exception boundary. Domain-specific machine data, when present, is nested under details.

statusCodeRequired

HTTP status code repeated from the response.

integer

Full definition

{
  "type": "integer",
  "description": "HTTP status code repeated from the response.",
  "example": 400
}

errorRequired

Translation key for the HTTP category, such as errors:http.conflict. The specific cause is identified by code and translationKey.

string

Full definition

{
  "type": "string",
  "description": "Translation key for the HTTP category, such as errors:http.conflict. The specific cause is identified by code and translationKey.",
  "example": "errors.request.invalid"
}

codeRequired

Stable machine-readable domain code, or an HTTP_* fallback when no domain code is provided. Branch on this field and the HTTP status; localized wording never controls retries or business decisions.

string

Full definition

{
  "type": "string",
  "example": "HTTP_BAD_REQUEST",
  "description": "Stable machine-readable domain code, or an HTTP_* fallback when no domain code is provided. Branch on this field and the HTTP status; localized wording never controls retries or business decisions."
}

messageRequired

Translation key, identical to translationKey. The API does not return localized display text. Resolve the key and translationValues in the consuming application.

string

Full definition

{
  "type": "string",
  "example": "errors:http.badRequest",
  "description": "Translation key, identical to translationKey. The API does not return localized display text. Resolve the key and translationValues in the consuming application."
}

translationKeyRequired

Canonical translation key, identical to message. Status-specific errors:http.* keys cover unspecified failures. Public keys and EN/RU explanations are listed in Developers; unknown keys require a localized client fallback.

string

Full definition

{
  "type": "string",
  "example": "errors:http.badRequest",
  "description": "Canonical translation key, identical to message. Status-specific errors:http.* keys cover unspecified failures. Public keys and EN/RU explanations are listed in Developers; unknown keys require a localized client fallback."
}

translationValuesOptional

Optional scalar values for placeholders in the translation. Treat values as data, escape them when rendering, and never use them as translation options.

object

Full definition

{
  "type": "object",
  "additionalProperties": {
    "oneOf": [
      {
        "type": "string",
        "example": "example"
      },
      {
        "type": "number",
        "example": 0
      },
      {
        "type": "boolean",
        "example": true
      }
    ],
    "example": "example"
  },
  "description": "Optional scalar values for placeholders in the translation. Treat values as data, escape them when rendering, and never use them as translation options.",
  "example": {
    "exampleKey": "example"
  }
}

validationErrorsOptional

Field validation failures with translation keys and stable validator codes. Submitted values and raw validator text are not included.

array

Full definition

{
  "description": "Field validation failures with translation keys and stable validator codes. Submitted values and raw validator text are not included.",
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/ValidationErrorDto"
  },
  "example": [
    {
      "field": "email",
      "translationKey": "validation:isEmail",
      "code": "isEmail",
      "message": "validation:isEmail"
    }
  ]
}

detailsOptional

Optional domain-specific blocker or validation details

oneOf

Full definition

{
  "description": "Optional domain-specific blocker or validation details",
  "oneOf": [
    {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": [
        "example"
      ]
    },
    {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": {
        "exampleKey": "example"
      }
    }
  ],
  "example": [
    "example"
  ]
}

{
  "type": "object",
  "properties": {
    "statusCode": {
      "type": "integer",
      "description": "HTTP status code repeated from the response.",
      "example": 400
    },
    "error": {
      "type": "string",
      "description": "Translation key for the HTTP category, such as errors:http.conflict. The specific cause is identified by code and translationKey.",
      "example": "errors.request.invalid"
    },
    "code": {
      "type": "string",
      "example": "HTTP_BAD_REQUEST",
      "description": "Stable machine-readable domain code, or an HTTP_* fallback when no domain code is provided. Branch on this field and the HTTP status; localized wording never controls retries or business decisions."
    },
    "message": {
      "type": "string",
      "example": "errors:http.badRequest",
      "description": "Translation key, identical to translationKey. The API does not return localized display text. Resolve the key and translationValues in the consuming application."
    },
    "translationKey": {
      "type": "string",
      "example": "errors:http.badRequest",
      "description": "Canonical translation key, identical to message. Status-specific errors:http.* keys cover unspecified failures. Public keys and EN/RU explanations are listed in Developers; unknown keys require a localized client fallback."
    },
    "translationValues": {
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string",
            "example": "example"
          },
          {
            "type": "number",
            "example": 0
          },
          {
            "type": "boolean",
            "example": true
          }
        ],
        "example": "example"
      },
      "description": "Optional scalar values for placeholders in the translation. Treat values as data, escape them when rendering, and never use them as translation options.",
      "example": {
        "exampleKey": "example"
      }
    },
    "validationErrors": {
      "description": "Field validation failures with translation keys and stable validator codes. Submitted values and raw validator text are not included.",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ValidationErrorDto"
      },
      "example": [
        {
          "field": "email",
          "translationKey": "validation:isEmail",
          "code": "isEmail",
          "message": "validation:isEmail"
        }
      ]
    },
    "details": {
      "description": "Optional domain-specific blocker or validation details",
      "oneOf": [
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/JsonValue"
          },
          "example": [
            "example"
          ]
        },
        {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/JsonValue"
          },
          "example": {
            "exampleKey": "example"
          }
        }
      ],
      "example": [
        "example"
      ]
    }
  },
  "required": [
    "statusCode",
    "error",
    "code",
    "message",
    "translationKey"
  ],
  "description": "Stable error envelope emitted by the global HTTP exception boundary. Domain-specific machine data, when present, is nested under details.",
  "example": {
    "statusCode": 400,
    "error": "errors:http.badRequest",
    "code": "HTTP_BAD_REQUEST",
    "message": "errors:http.badRequest",
    "translationKey": "errors:http.badRequest"
  }
}

Field validation failure with a field path, stable validator code and a translation key. Human-readable text belongs to the consuming application.

fieldRequired

Public field path. Nested properties and array indices are separated by dots.

string

Full definition

{
  "type": "string",
  "example": "email",
  "description": "Public field path. Nested properties and array indices are separated by dots."
}

translationKeyRequired

Translation key for this validator, identical to message. Resolve it using a client dictionary; see the public Developers error catalog.

string

Full definition

{
  "type": "string",
  "example": "validation:isEmail",
  "description": "Translation key for this validator, identical to message. Resolve it using a client dictionary; see the public Developers error catalog."
}

codeRequired

Stable validator identifier for this field failure. Custom validators may define additional identifiers.

string

Full definition

{
  "type": "string",
  "example": "isEmail",
  "description": "Stable validator identifier for this field failure. Custom validators may define additional identifiers."
}

messageRequired

Translation key describing this field validation failure, identical to translationKey. Submitted values and validator prose are not included.

string

Full definition

{
  "type": "string",
  "example": "validation:isEmail",
  "description": "Translation key describing this field validation failure, identical to translationKey. Submitted values and validator prose are not included."
}

translationValuesOptional

Optional scalar values for placeholders in the translation. Treat values as data, escape them when rendering, and never use them as translation options.

object

Full definition

{
  "type": "object",
  "additionalProperties": {
    "oneOf": [
      {
        "type": "string",
        "example": "example"
      },
      {
        "type": "number",
        "example": 0
      },
      {
        "type": "boolean",
        "example": true
      }
    ],
    "example": "example"
  },
  "description": "Optional scalar values for placeholders in the translation. Treat values as data, escape them when rendering, and never use them as translation options.",
  "example": {
    "exampleKey": "example"
  }
}

{
  "type": "object",
  "properties": {
    "field": {
      "type": "string",
      "example": "email",
      "description": "Public field path. Nested properties and array indices are separated by dots."
    },
    "translationKey": {
      "type": "string",
      "example": "validation:isEmail",
      "description": "Translation key for this validator, identical to message. Resolve it using a client dictionary; see the public Developers error catalog."
    },
    "code": {
      "type": "string",
      "example": "isEmail",
      "description": "Stable validator identifier for this field failure. Custom validators may define additional identifiers."
    },
    "message": {
      "type": "string",
      "example": "validation:isEmail",
      "description": "Translation key describing this field validation failure, identical to translationKey. Submitted values and validator prose are not included."
    },
    "translationValues": {
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "string",
            "example": "example"
          },
          {
            "type": "number",
            "example": 0
          },
          {
            "type": "boolean",
            "example": true
          }
        ],
        "example": "example"
      },
      "description": "Optional scalar values for placeholders in the translation. Treat values as data, escape them when rendering, and never use them as translation options.",
      "example": {
        "exampleKey": "example"
      }
    }
  },
  "required": [
    "field",
    "translationKey",
    "code",
    "message"
  ],
  "description": "Field validation failure with a field path, stable validator code and a translation key. Human-readable text belongs to the consuming application.",
  "example": {
    "field": "email",
    "translationKey": "validation:isEmail",
    "code": "isEmail",
    "message": "validation:isEmail"
  }
}

Recursively JSON-safe value used only where the owning contract intentionally allows free-form structured data.

{
  "oneOf": [
    {
      "type": "string",
      "nullable": true,
      "example": "example"
    },
    {
      "type": "number",
      "example": 0
    },
    {
      "type": "boolean",
      "example": true
    },
    {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": [
        "example"
      ]
    },
    {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/components/schemas/JsonValue"
      },
      "example": {
        "exampleKey": "example"
      }
    }
  ],
  "description": "Recursively JSON-safe value used only where the owning contract intentionally allows free-form structured data.",
  "example": "example"
}