---
title: "Завести своё приложение или переименовать его"
method: POST
path: "/api/v1/developer/apps"
tags: ["Developer account"]
---

# Завести своё приложение или переименовать его

`POST /api/v1/developer/apps`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/developer/apps`
- Auth: HTTP bearer

Издателя в теле нет: пространство имён выдаётся владельцу издателя, а не выбирается запросом. Состояния тоже нет — выключатель приложения принадлежит платформе, и приложение, погашенное посреди инцидента, не оживает правкой названия.

Действие человеческое: ключ приложения его не выполняет. Пространство имён выдаётся один раз и навсегда, а машина не читает предупреждений.

## Request body

- DeveloperAppInput
  - `key` string, required: Ключ приложения: строчные латинские буквы, цифры и дефисы. Издатель приезжает из владельца пространства имён и в теле не называется
  - `title` string: Название, которое увидит администратор кабинета на экране согласия

## Response `200`

Приложение заведено или переименовано

- DeveloperAppResult
  - `app` PlatformApp, required
    - `id` string, uuid, required
    - `publisher` string, required: Издатель: строчные латинские буквы, цифры и дефисы
    - `key` string, required: Ключ приложения; вместе с издателем образует пространство имён app.<издатель>.<ключ>
    - `title` string, required
    - `status` 'draft' | 'published' | 'suspended' | 'retired', required: draft и published — приложение живо; suspended и retired гасят все его установки во всех кабинетах
    - `internal` boolean: Наше приложение: его установка получает долгий потолок срока жизни токена. Ставится персоналом платформы, из манифеста не выводится
    - `created_by` integer: Сотрудник платформы, заведший приложение
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Действие требует человека, а не ключа приложения
- `409`: Издателя ещё нет, издателей несколько, либо приложение выключено платформой

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)