---
title: "🔓 Запрос кода входа на телефон или email (#26729): код действует 5 минут, пока он действует, новый не выдаётся. Число запросов и неверных попыток на контакт ограничено. Email - только при настроенной почте."
method: GET
path: "/signin/code"
tags: ["Auth"]
---

# 🔓 Запрос кода входа на телефон или email (#26729): код действует 5 минут, пока он действует, новый не выдаётся. Число запросов и неверных попыток на контакт ограничено. Email - только при настроенной почте.

`GET /signin/code`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/signin/code`
- Auth: none required

Запрос кода входа на телефон или email (#26729): код действует 5 минут, пока он действует, новый не выдаётся. Число запросов и неверных попыток на контакт ограничено. Email - только при настроенной почте.

**Access:** `unauthorized` (0 ) · **Scope:** `write` · **только веб-сессия**

### TypeScript (copy-paste)

**`GET /signin/code`**

<details open><summary><b>Params</b></summary>

```typescript
export interface SigninCodeParams {
  phone?: string | null
  email?: string | null
}
```

</details>

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

```typescript
export type SigninCodeResponse = IServerResponse<Resp_signin_code>

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)

## Query parameters

- `phone` string, nullable
- `email` string, nullable

## Headers

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

## Response `200`

OK — `IServerResponse<Resp_signin_code>`

- object
  - `code` integer, required
  - `data` RespSigninCode, required: ResponseData for signin/code
    - `codeStatus` 0 | 1 | -1, required: `wait` = 0, `sended` = 1, `error` = -1
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest: exactly one of phone or email is required, or the contact is invalid
- `422`: UnprocessableContent: params.code - code_already_sent (active code exists), code_requests_exceeded, code_send_failed, email_unavailable

---

[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)