---
title: "🔒 Выпуск одноразового кода сквозной авторизации (handoff) для действующей сессии. Код обменивается на дочернюю сессию через signin/handoff."
method: GET
path: "/session/handoff"
tags: ["Auth"]
---

# 🔒 Выпуск одноразового кода сквозной авторизации (handoff) для действующей сессии. Код обменивается на дочернюю сессию через signin/handoff.

`GET /session/handoff`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/session/handoff`
- Auth: API key in header `sid` and API key in header `rts` and API key in header `sig`

Выпуск одноразового кода сквозной авторизации (handoff) для действующей сессии. Код обменивается на дочернюю сессию через signin/handoff.

**Access:** `authorized` (10 ) · **allowNullCompany:** true · **Scope:** `write` · **только веб-сессия**

**Allows:** не требуются — handoff code of the current session

### TypeScript (copy-paste)

**`GET /session/handoff`**

<details open><summary><b>Response</b></summary>

```typescript
export type SessionHandoffResponse = IServerResponse<Resp_session_handoff>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Response `200`

OK — `IServerResponse<Resp_session_handoff>`

- object
  - `code` integer, required
  - `data` RespSessionHandoff, required: ResponseData for session/handoff
    - `code` string, required: Одноразовый код для обмена на дочернюю сессию через `signin/handoff`
    - `expTs` number, required: Момент, после которого код недействителен (мс)
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest / Validation — неверные params/body/headers
- `401`: Unauthorized: Active user session required
- `403`: AccessNotAllowed — недостаточно прав или неверная подпись
- `406`: TimeResync — расхождение rts с сервером
- `422`: UnprocessableContent: Handoff rate limit exceeded

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)