Авторизация
Authorization: Bearer <HALLIFY_PREORDER_MANAGE_TOKEN>Гостевой токен управления своим предзаказом.
Параметры
idempotency-keyЗаголовок · ОбязательноОбязательный ключ идемпотентности длиной до 128 символов.
stringПолное определение
{ "type": "string", "minLength": 1, "maxLength": 128, "example": "example" }originЗаголовок · ОбязательноФактический браузерный Origin, соответствующий исходному классифицированному нативному представлению и текущим полномочиям продолжения. Виджет сохраняет Origin изолированного frame; origin встраивающей страницы его не заменяет.
stringПолное определение
{ "type": "string", "maxLength": 2048, "example": "example" }
Ответы
200Исходная приватная цель восстановления существующего контакта, ограниченная допущенным нативным максимумом. Доступ в Portal требует настоящего подтверждения OTP.
Полное определение
{
"$ref": "#/components/schemas/GuestNativePortalIngressResultDto"
}{
"reentryContext": {
"hint": "gpr1_synthetic_recovery_context_example_not_a_runtime_credential_0000000000",
"expiresAt": "2026-12-31T18:00:00.000Z"
}
}400Обязательный ключ идемпотентности пуст, превышает 128 символов либо тело или query не отсутствуют и не являются пустыми объектами. Null, массивы, примитивы и переданные поля тела или query отклоняются.
Полное определение
{
"$ref": "#/components/schemas/TranslatedErrorDto"
}{
"statusCode": 400,
"error": "errors:http.badRequest",
"code": "HTTP_BAD_REQUEST",
"message": "errors:http.badRequest",
"translationKey": "errors:http.badRequest"
}401Отклоняет отсутствующий, некорректный, истёкший, отозванный или недействительный ключ preorderManageToken на границе владеющего домена.
Полное определение
{
"$ref": "#/components/schemas/TranslatedErrorDto"
}{
"statusCode": 401,
"error": "errors:http.unauthorized",
"code": "HTTP_UNAUTHORIZED",
"message": "errors:http.unauthorized",
"translationKey": "errors:http.unauthorized"
}402У исходного нативного ORDER нет сохранённого допуска операционного продолжения. Код ошибки: BILLING_OPERATION_NOT_ADMITTED. Подготовка цели Portal не создаёт новое коммерческое покрытие.
Полное определение
{
"$ref": "#/components/schemas/TranslatedErrorDto"
}{
"statusCode": 402,
"error": "errors:http.failure",
"code": "HTTP_402",
"message": "errors:http.failure",
"translationKey": "errors:http.failure"
}404Недоступны текущая нативная SESSION, область READ, сохранённое происхождение, точные гостевые личность и профиль, семейство доступа или текущее представление. Отсутствующий или несовпадающий Origin также отклоняется. Код ошибки: PREORDER_PUBLIC_RESOURCE_NOT_FOUND.
Полное определение
{
"$ref": "#/components/schemas/TranslatedErrorDto"
}{
"statusCode": 404,
"error": "errors:http.notFound",
"code": "HTTP_NOT_FOUND",
"message": "errors:http.notFound",
"translationKey": "errors:http.notFound"
}409Ключ идемпотентности уже обрабатывается или повторно использован с другим телом.
Полное определение
{
"$ref": "#/components/schemas/IdempotencyConflictError"
}{
"statusCode": 409,
"error": "errors:http.conflict",
"code": "IDEMPOTENCY_REQUEST_IN_PROGRESS",
"message": "errors:idempotency.inProgress",
"translationKey": "errors:idempotency.inProgress"
}429Достигнут нативный лимит управления. Код ошибки: RATE_LIMITED. Retry-After указывает оставшуюся задержку в целых секундах.
Заголовки ответа
Retry-AfterЦелое количество секунд ожидания перед повтором отклонённого запроса.
integerПолное определение
{
"type": "integer",
"minimum": 1,
"example": 60
}Полное определение
{
"$ref": "#/components/schemas/TranslatedErrorDto"
}{
"statusCode": 429,
"error": "errors:http.tooManyRequests",
"code": "HTTP_TOO_MANY_REQUESTS",
"message": "errors:http.tooManyRequests",
"translationKey": "errors:http.tooManyRequests"
}503Невозможно безопасно определить текущий допуск, сохранённое подтверждение, шифрование или исходное состояние команды. При повторе необходимо сохранить тот же ключ идемпотентности.
Полное определение
{
"$ref": "#/components/schemas/TranslatedErrorDto"
}{
"statusCode": 503,
"error": "errors:http.serviceUnavailable",
"code": "HTTP_SERVICE_UNAVAILABLE",
"message": "errors:http.serviceUnavailable",
"translationKey": "errors:http.serviceUnavailable"
}Схемы
GuestNativePortalIngressResultDto
Приватная цель кода контакта, подготовленная из собственной нативной брони, waitlist или предзаказа гостя. Не даёт доступа в Portal до успешного существующего настоящего OTP.
reentryContextОбязательноИсходная ограниченная цель восстановления существующего гостевого контакта. Храните её приватно, запрашивайте и подтверждайте настоящий код через канонический сценарий повторного входа Guest Portal.
allOfПолное определение
{ "readOnly": true, "description": "Исходная ограниченная цель восстановления существующего гостевого контакта. Храните её приватно, запрашивайте и подтверждайте настоящий код через канонический сценарий повторного входа Guest Portal.", "allOf": [ { "$ref": "#/components/schemas/GuestPortalReentryContextDto" } ], "example": { "hint": "gpr1_synthetic_recovery_context_example_not_a_runtime_credential_0000000000", "expiresAt": "2026-12-31T18:00:00.000Z" } }
Полное определение
{
"type": "object",
"properties": {
"reentryContext": {
"readOnly": true,
"description": "Исходная ограниченная цель восстановления существующего гостевого контакта. Храните её приватно, запрашивайте и подтверждайте настоящий код через канонический сценарий повторного входа Guest Portal.",
"allOf": [
{
"$ref": "#/components/schemas/GuestPortalReentryContextDto"
}
],
"example": {
"hint": "gpr1_synthetic_recovery_context_example_not_a_runtime_credential_0000000000",
"expiresAt": "2026-12-31T18:00:00.000Z"
}
}
},
"description": "Приватная цель кода контакта, подготовленная из собственной нативной брони, waitlist или предзаказа гостя. Не даёт доступа в Portal до успешного существующего настоящего OTP.",
"required": [
"reentryContext"
],
"example": {
"reentryContext": {
"hint": "gpr1_synthetic_recovery_context_example_not_a_runtime_credential_0000000000",
"expiresAt": "2026-12-31T18:00:00.000Z"
}
}
}GuestPortalReentryContextDto
Контекст восстановления исходного существующего контакта гостя и области кабинета не предоставляет права чтения. Для непроверенного кандидата по-прежнему требуется успешное подтверждение OTP. Контекст разрешает только целевой сценарий повторного входа, но не доступ к кабинету, входящим сообщениям или push.
hintОбязательноНепрозрачная подсказка для восстановления с проверкой подлинности. Храните её только для выбора исходного контекста: она не является токеном доступа к порталу гостя или разрешением на push.
stringПолное определение
{ "type": "string", "description": "Непрозрачная подсказка для восстановления с проверкой подлинности. Храните её только для выбора исходного контекста: она не является токеном доступа к порталу гостя или разрешением на push.", "minLength": 64, "maxLength": 2048, "pattern": "^gpr1_[A-Za-z0-9_-]+$", "example": "gpr1_synthetic_recovery_context_example_not_a_runtime_credential_0000000000", "readOnly": true }expiresAtОбязательноАбсолютный срок действия контекста восстановления. Перед каждым запросом кода и подтверждением сервер проверяет текущего гостя, исходный контакт и область доступа портала.
string · date-timeПолное определение
{ "type": "string", "description": "Абсолютный срок действия контекста восстановления. Перед каждым запросом кода и подтверждением сервер проверяет текущего гостя, исходный контакт и область доступа портала.", "format": "date-time", "readOnly": true, "example": "2026-12-31T18:00:00.000Z" }
Полное определение
{
"type": "object",
"properties": {
"hint": {
"type": "string",
"description": "Непрозрачная подсказка для восстановления с проверкой подлинности. Храните её только для выбора исходного контекста: она не является токеном доступа к порталу гостя или разрешением на push.",
"minLength": 64,
"maxLength": 2048,
"pattern": "^gpr1_[A-Za-z0-9_-]+$",
"example": "gpr1_synthetic_recovery_context_example_not_a_runtime_credential_0000000000",
"readOnly": true
},
"expiresAt": {
"type": "string",
"description": "Абсолютный срок действия контекста восстановления. Перед каждым запросом кода и подтверждением сервер проверяет текущего гостя, исходный контакт и область доступа портала.",
"format": "date-time",
"readOnly": true,
"example": "2026-12-31T18:00:00.000Z"
}
},
"description": "Контекст восстановления исходного существующего контакта гостя и области кабинета не предоставляет права чтения. Для непроверенного кандидата по-прежнему требуется успешное подтверждение OTP. Контекст разрешает только целевой сценарий повторного входа, но не доступ к кабинету, входящим сообщениям или push.",
"required": [
"hint",
"expiresAt"
],
"example": {
"hint": "gpr1_synthetic_recovery_context_example_not_a_runtime_credential_0000000000",
"expiresAt": "2026-12-31T18:00:00.000Z"
}
}TranslatedErrorDto
Стабильная оболочка ошибки общего обработчика HTTP-исключений. Дополнительные машинные данные домена вложены в details.
statusCodeОбязательноHTTP-статус, повторённый из ответа.
integerПолное определение
{ "type": "integer", "description": "HTTP-статус, повторённый из ответа.", "example": 400 }errorОбязательноКлюч перевода HTTP-категории, например errors:http.conflict. Конкретную причину определяют code и translationKey.
stringПолное определение
{ "type": "string", "description": "Ключ перевода HTTP-категории, например errors:http.conflict. Конкретную причину определяют code и translationKey.", "example": "errors.request.invalid" }codeОбязательноСтабильный машинный код домена либо стандартный HTTP_*, если доменный код не задан. Используйте это поле и HTTP-статус для программной логики; локализованная формулировка не управляет повторами или бизнес-решениями.
stringПолное определение
{ "type": "string", "example": "HTTP_BAD_REQUEST", "description": "Стабильный машинный код домена либо стандартный HTTP_*, если доменный код не задан. Используйте это поле и HTTP-статус для программной логики; локализованная формулировка не управляет повторами или бизнес-решениями." }messageОбязательноКлюч перевода, идентичный translationKey. API не возвращает локализованный текст интерфейса. Найдите перевод ключа и подставьте translationValues в приложении-потребителе.
stringПолное определение
{ "type": "string", "example": "errors:http.badRequest", "description": "Ключ перевода, идентичный translationKey. API не возвращает локализованный текст интерфейса. Найдите перевод ключа и подставьте translationValues в приложении-потребителе." }translationKeyОбязательноКанонический ключ перевода, идентичный message. Ключи errors:http.* соответствующего статуса описывают неуточнённые ошибки. Публичные ключи и пояснения EN/RU перечислены в Developers; неизвестный ключ требует локализованного запасного сообщения в клиенте.
stringПолное определение
{ "type": "string", "example": "errors:http.badRequest", "description": "Канонический ключ перевода, идентичный message. Ключи errors:http.* соответствующего статуса описывают неуточнённые ошибки. Публичные ключи и пояснения EN/RU перечислены в Developers; неизвестный ключ требует локализованного запасного сообщения в клиенте." }translationValuesНеобязательноНеобязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.
objectПолное определение
{ "type": "object", "additionalProperties": { "oneOf": [ { "type": "string", "example": "example" }, { "type": "number", "example": 0 }, { "type": "boolean", "example": true } ], "example": "example" }, "description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.", "example": { "exampleKey": "example" } }validationErrorsНеобязательноОшибки проверки полей с ключами переводов и стабильными кодами валидаторов. Введённые значения и исходные тексты валидаторов не включаются.
arrayПолное определение
{ "description": "Ошибки проверки полей с ключами переводов и стабильными кодами валидаторов. Введённые значения и исходные тексты валидаторов не включаются.", "type": "array", "items": { "$ref": "#/components/schemas/ValidationErrorDto" }, "example": [ { "field": "email", "translationKey": "validation:isEmail", "code": "isEmail", "message": "validation:isEmail" } ] }detailsНеобязательноНеобязательные сведения о доменных препятствиях или ошибках валидации.
oneOfПолное определение
{ "description": "Необязательные сведения о доменных препятствиях или ошибках валидации.", "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-статус, повторённый из ответа.",
"example": 400
},
"error": {
"type": "string",
"description": "Ключ перевода HTTP-категории, например errors:http.conflict. Конкретную причину определяют code и translationKey.",
"example": "errors.request.invalid"
},
"code": {
"type": "string",
"example": "HTTP_BAD_REQUEST",
"description": "Стабильный машинный код домена либо стандартный HTTP_*, если доменный код не задан. Используйте это поле и HTTP-статус для программной логики; локализованная формулировка не управляет повторами или бизнес-решениями."
},
"message": {
"type": "string",
"example": "errors:http.badRequest",
"description": "Ключ перевода, идентичный translationKey. API не возвращает локализованный текст интерфейса. Найдите перевод ключа и подставьте translationValues в приложении-потребителе."
},
"translationKey": {
"type": "string",
"example": "errors:http.badRequest",
"description": "Канонический ключ перевода, идентичный message. Ключи errors:http.* соответствующего статуса описывают неуточнённые ошибки. Публичные ключи и пояснения EN/RU перечислены в Developers; неизвестный ключ требует локализованного запасного сообщения в клиенте."
},
"translationValues": {
"type": "object",
"additionalProperties": {
"oneOf": [
{
"type": "string",
"example": "example"
},
{
"type": "number",
"example": 0
},
{
"type": "boolean",
"example": true
}
],
"example": "example"
},
"description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.",
"example": {
"exampleKey": "example"
}
},
"validationErrors": {
"description": "Ошибки проверки полей с ключами переводов и стабильными кодами валидаторов. Введённые значения и исходные тексты валидаторов не включаются.",
"type": "array",
"items": {
"$ref": "#/components/schemas/ValidationErrorDto"
},
"example": [
{
"field": "email",
"translationKey": "validation:isEmail",
"code": "isEmail",
"message": "validation:isEmail"
}
]
},
"details": {
"description": "Необязательные сведения о доменных препятствиях или ошибках валидации.",
"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": "Стабильная оболочка ошибки общего обработчика HTTP-исключений. Дополнительные машинные данные домена вложены в details.",
"example": {
"statusCode": 400,
"error": "errors:http.badRequest",
"code": "HTTP_BAD_REQUEST",
"message": "errors:http.badRequest",
"translationKey": "errors:http.badRequest"
}
}ValidationErrorDto
Ошибка проверки поля с путём поля, стабильным кодом валидатора и ключом перевода. Человекочитаемый текст принадлежит приложению-потребителю.
fieldОбязательноПубличный путь поля. Вложенные свойства и индексы массива разделены точками.
stringПолное определение
{ "type": "string", "example": "email", "description": "Публичный путь поля. Вложенные свойства и индексы массива разделены точками." }translationKeyОбязательноКлюч перевода этого валидатора, идентичный message. Найдите его в клиентском словаре; см. публичный каталог ошибок Developers.
stringПолное определение
{ "type": "string", "example": "validation:isEmail", "description": "Ключ перевода этого валидатора, идентичный message. Найдите его в клиентском словаре; см. публичный каталог ошибок Developers." }codeОбязательноСтабильный идентификатор валидатора для ошибки поля. Пользовательские валидаторы могут определять дополнительные идентификаторы.
stringПолное определение
{ "type": "string", "example": "isEmail", "description": "Стабильный идентификатор валидатора для ошибки поля. Пользовательские валидаторы могут определять дополнительные идентификаторы." }messageОбязательноКлюч перевода, описывающий ошибку проверки поля, идентичный translationKey. Введённые значения и тексты валидаторов не включаются.
stringПолное определение
{ "type": "string", "example": "validation:isEmail", "description": "Ключ перевода, описывающий ошибку проверки поля, идентичный translationKey. Введённые значения и тексты валидаторов не включаются." }translationValuesНеобязательноНеобязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.
objectПолное определение
{ "type": "object", "additionalProperties": { "oneOf": [ { "type": "string", "example": "example" }, { "type": "number", "example": 0 }, { "type": "boolean", "example": true } ], "example": "example" }, "description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.", "example": { "exampleKey": "example" } }
Полное определение
{
"type": "object",
"properties": {
"field": {
"type": "string",
"example": "email",
"description": "Публичный путь поля. Вложенные свойства и индексы массива разделены точками."
},
"translationKey": {
"type": "string",
"example": "validation:isEmail",
"description": "Ключ перевода этого валидатора, идентичный message. Найдите его в клиентском словаре; см. публичный каталог ошибок Developers."
},
"code": {
"type": "string",
"example": "isEmail",
"description": "Стабильный идентификатор валидатора для ошибки поля. Пользовательские валидаторы могут определять дополнительные идентификаторы."
},
"message": {
"type": "string",
"example": "validation:isEmail",
"description": "Ключ перевода, описывающий ошибку проверки поля, идентичный translationKey. Введённые значения и тексты валидаторов не включаются."
},
"translationValues": {
"type": "object",
"additionalProperties": {
"oneOf": [
{
"type": "string",
"example": "example"
},
{
"type": "number",
"example": 0
},
{
"type": "boolean",
"example": true
}
],
"example": "example"
},
"description": "Необязательные скалярные значения параметров шаблона перевода. Обрабатывайте их как данные, экранируйте при отображении и никогда не используйте как настройки переводчика.",
"example": {
"exampleKey": "example"
}
}
},
"required": [
"field",
"translationKey",
"code",
"message"
],
"description": "Ошибка проверки поля с путём поля, стабильным кодом валидатора и ключом перевода. Человекочитаемый текст принадлежит приложению-потребителю.",
"example": {
"field": "email",
"translationKey": "validation:isEmail",
"code": "isEmail",
"message": "validation:isEmail"
}
}JsonValue
Рекурсивно допустимое JSON-значение. Используется только там, где контракт явно разрешает произвольные структурированные данные.
Полное определение
{
"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": "Рекурсивно допустимое JSON-значение. Используется только там, где контракт явно разрешает произвольные структурированные данные.",
"example": "example"
}IdempotencyConflictError
Ключ идемпотентности уже обрабатывается или использован повторно с другим телом.
Полное определение
{
"example": {
"statusCode": 409,
"error": "errors:http.conflict",
"code": "IDEMPOTENCY_REQUEST_IN_PROGRESS",
"message": "errors:idempotency.inProgress",
"translationKey": "errors:idempotency.inProgress"
},
"allOf": [
{
"$ref": "#/components/schemas/TranslatedErrorDto"
},
{
"type": "object",
"required": [
"code"
],
"properties": {
"statusCode": {
"type": "integer",
"enum": [
409
],
"description": "Статус конфликта HTTP 409.",
"example": 409
},
"code": {
"type": "string",
"enum": [
"IDEMPOTENCY_REQUEST_NOT_READY",
"IDEMPOTENCY_KEY_PAYLOAD_MISMATCH",
"IDEMPOTENCY_REQUEST_IN_PROGRESS",
"IDEMPOTENCY_SCOPE_INCOMPLETE"
],
"description": "Допустимые значения `code`: IDEMPOTENCY_REQUEST_NOT_READY, IDEMPOTENCY_KEY_PAYLOAD_MISMATCH, IDEMPOTENCY_REQUEST_IN_PROGRESS, IDEMPOTENCY_SCOPE_INCOMPLETE.",
"example": "IDEMPOTENCY_REQUEST_NOT_READY"
}
},
"example": {
"code": "IDEMPOTENCY_REQUEST_NOT_READY"
}
}
],
"description": "Ключ идемпотентности уже обрабатывается или использован повторно с другим телом."
}