> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth API: регистрация через API

> Создавайте организации Didit программно через Auth API: без браузера, для агентов. KYC-инфраструктура для субаккаунтов, оплата за вызов, без контрактов.



Программный промпт для регистрации
        Скопировать промпт в буфер обмена



      
      

\<pre>

\``Programmatically create a pending Didit account — step 1 of the two-step onboarding (no browser, no console).

Endpoint:
POST https://apx.didit.me/auth/v2/programmatic/register/

Authentication:
None. This is a public endpoint. (Don't confuse the Auth API host `apx.didit.me/auth/v2` with the verification host `verification.didit.me/v3`.)

Request body:
\- email (string, required) — Any real, deliverable email (personal, work, alias). The verification code is mailed synchronously, so reserved test domains (`@example.com`, `@example.org`, `@*.test`, `@*.example`, `@*.invalid`) get rejected by mail delivery and the call returns `500` — substitute the placeholder with an inbox you can read.
\- password (string, required) — Must satisfy ALL of: minimum 8 characters, ≥1 uppercase letter (A-Z), ≥1 lowercase letter (a-z), ≥1 digit (0-9), ≥1 special character from !@#$%^&*()_+-=[]{}|;:,.<>?. Rules are validated one at a time and the first failure short-circuits.

curl example (replace `you@yourdomain.com` with a real inbox):
curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \
-H "Content-Type: application/json" \
-d '{
"email": "you@yourdomain.com",
"password": "MyStr0ng!Pass"
}'

Response (201 Created):
\- message (string) — "Registration successful. Check your email for the verification code."
\- email (string) — echoed back.

What happens server-side:
\- A pending account is created (NOT usable yet).
\- A 6-character alphanumeric code (e.g. "A3K9F2") is emailed to the supplied address.
\- The code is valid for 15 minutes. After expiry the registration must be redone.

Failure modes (all 400 unless noted):
\- Field-level: { "email": ["Enter a valid email address."] } or { "password": ["Ensure this field has at least 8 characters."] }.
\- Password-strength failures CURRENTLY return as a BARE ARRAY (no field key), one rule at a time: ["Password must contain at least one uppercase letter."] / lowercase / digit / special character. Known server-side inconsistency — treat as { "password": [...] } client-side.
\- Duplicate email: { "detail": "An account with this email already exists." }
\- 429 — { "detail": "Too many registration attempts. Please try again later.", "wait": <seconds> } when more than 5 registrations from the same IP within an hour.
\- 500 — returned (with an HTML body, not JSON) when mail delivery to the supplied address fails synchronously. Most commonly triggered by reserved test domains; use a real inbox.

Rate limits:
5 registrations per IP per hour.

Next step:
After receiving the email, call POST https://apx.didit.me/auth/v2/programmatic/verify-email/ with { "email", "code" } to get your access_token and api_key — see /auth-api/verify-email.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.``

\</pre>



      
      

Вставьте в



## OpenAPI

````yaml ru/openapi-auth.json POST /programmatic/register/
openapi: 3.0.0
info:
  version: 1.0.0
  title: Didit Auth API
  description: >-
    API программной регистрации и аутентификации для разработчиков и AI-агентов.
    Регистрация за 2 вызова API: без использования браузера. Самая удобная для
    агентов платформа верификации личности.


    ## Базовый URL


    Все endpoint в этой спецификации размещены по адресу
    `https://apx.didit.me/auth/v2`. Это другой хост, отличный от API верификации
    (`https://verification.didit.me/v3`). Не путайте их: этот хост
    аутентификации выдаёт ваши **токены доступа JWT** и позволяет просматривать
    список и управлять вашими **организациями** и **приложениями**. На хосте
    верификации вы вызываете сессии, сценарии, AML и т. д., аутентифицируясь с
    помощью **`api_key`**, возвращаемого этим API.


    ## Как устроен процесс аутентификации


    1. `POST /programmatic/register/`: отправьте email + пароль.

    2. Получите 6-значный буквенно-цифровой код по электронной почте.

    3. `POST /programmatic/verify-email/`: отправьте код. Вы получите обратно
    JWT `access_token`, `refresh_token`, организацию и стандартное приложение с
    `client_id` + `api_key`.

    4. Сохраните `api_key`. Используйте его в качестве `x-api-key` для каждого
    вызова к `https://verification.didit.me/v3/...`.

    5. В дальнейшем с любой машины `POST /programmatic/login/` обменивает ваши
    email + пароль на свежий JWT, после чего вызовите `GET /organizations/me/` и
    endpoint приложений для восстановления или ротации учётных данных.


    JWT требуется только для endpoint **Управления аккаунтом** в этой
    спецификации; трафик к API верификации использует долгоживущий `api_key`, а
    не JWT.


    ## Соглашения


    - Все тела запросов и ответов представляют собой JSON (`Content-Type:
    application/json`).

    - **Используйте реальный, доставляемый адрес электронной почты при
    тестировании `POST /programmatic/register/`.** Endpoint отправляет код
    подтверждения синхронно, поэтому адреса на зарезервированных тестовых
    доменах (`@example.com`, `@example.org`, `@*.test`, `@*.example`,
    `@*.invalid`) отклоняются службой доставки почты, и запрос возвращает `500`.
    Замените плейсхолдер `you@yourdomain.com` в примерах на почтовый ящик,
    который вы действительно можете прочитать.

    - Ошибки валидации возвращают HTTP `400` в одном из двух форматов:
    `{"field": ["message", ...]}` для проблем на уровне полей или `{"detail":
    "message"}` для ошибок бизнес-правил. Некоторые валидаторы (сложность пароля
    при регистрации, истечение срока действия кода при проверке email) в
    настоящее время возвращают простой массив `["message"]` вместо структуры с
    ключами полей - это известная несогласованность на стороне сервера, поэтому
    клиентский код должен принимать оба формата.

    - Ошибки аутентификации возвращаются в виде `{"detail": "..."}` с кодом HTTP
    `401` (недействительный bearer token) или `403` (отсутствует bearer token /
    недостаточно прав).

    - Ответы с ограничением частоты запросов содержат поле `wait` с временем
    задержки в секундах.
servers:
  - url: https://apx.didit.me/auth/v2
    description: Продакшн-сервер аутентификации
security: []
tags:
  - name: Programmatic Auth
    description: >-
      Жизненный цикл аккаунта с электронной почтой и паролем: регистрация,
      подтверждение, вход. Возвращает JWT `access_token`, который вы используете
      для endpoint'ов управления аккаунтом, а также (при подтверждении)
      `client_id` и `api_key` вашего первого приложения.
  - name: Account Management
    description: >-
      Аутентифицированные endpoint (JWT bearer), которые возвращают список
      организаций и позволяют создавать, получать или обновлять приложения.
      Используйте их для восстановления или ротации `api_key`, с помощью
      которого вы аутентифицируете вызовы API верификации.
paths:
  /programmatic/register/:
    post:
      tags:
        - Programmatic Auth
      summary: Зарегистрировать аккаунт
      description: >-
        Шаг 1 программного онбординга. Создает учетную запись в статусе ожидания
        и отправляет 6-значный код на электронную почту (срок действия 10 мин).
        Адрес проверяется до создания учетной записи: если на него невозможно
        доставить код, возвращается ошибка 400 `email_undeliverable`. Лимиты
        запросов: 5 с одного IP в час, плюс общий почасовой лимит на подсеть
        (/24 для IPv4, /64 для IPv6).
      operationId: programmatic_register
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterRequest'
            examples:
              Gmail:
                summary: Зарегистрироваться через личный адрес Gmail
                value:
                  email: you@yourdomain.com
                  password: MyStr0ng!Pass
              Work:
                summary: Зарегистрироваться с рабочей электронной почтой
                value:
                  email: you@yourcompany.com
                  password: C0mplex#Pass1
      responses:
        '201':
          description: >-
            Регистрация прошла успешно. 6-символьный буквенно-цифровой код
            подтверждения (например, `A3K9F2`) отправлен на указанный адрес
            электронной почты и действителен в течение 10 минут. Следующим шагом
            вызовите `POST /programmatic/verify-email/`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegisterResponse'
              examples:
                Success:
                  value:
                    message: >-
                      Registration successful. Check your email for the
                      verification code.
                    email: you@yourdomain.com
        '400':
          description: >-
            Ошибка валидации. Предполагаемая обёртка: `{"field": ["..."]}` для
            ошибок на уровне полей и `{"detail": "..."}` для ошибок
            бизнес-правил (например, повторяющийся адрес электронной почты).
            Правила надёжности пароля в настоящее время возвращают простой
            массив `["..."]`, по одному правилу за раз (известная
            несогласованность на стороне сервера; обрабатывайте её как
            `{"password": ["..."]}`, пока она не будет исправлена). Если адрес
            не может принять код (одноразовый, зарезервированный или тестовый
            домен, отсутствие почтового сервера, вероятная опечатка или адрес, с
            которого ранее возвращались письма), телом ответа является
            `EmailUndeliverableError` с `code: "email_undeliverable"`; аккаунт
            не создаётся и не изменяется.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ValidationError'
                  - $ref: '#/components/schemas/EmailUndeliverableError'
              examples:
                MissingFields:
                  summary: Пустое тело
                  value:
                    email:
                      - This field is required.
                    password:
                      - This field is required.
                InvalidEmail:
                  summary: Некорректный email
                  value:
                    email:
                      - Enter a valid email address.
                PasswordTooShort:
                  summary: Пароль короче 8 символов
                  value:
                    password:
                      - Ensure this field has at least 8 characters.
                PasswordMissingUppercase:
                  summary: В пароле отсутствует заглавная буква
                  value:
                    - Password must contain at least one uppercase letter.
                PasswordMissingLowercase:
                  summary: В пароле отсутствует строчная буква
                  value:
                    - Password must contain at least one lowercase letter.
                PasswordMissingDigit:
                  summary: В пароле отсутствует цифра
                  value:
                    - Password must contain at least one digit.
                PasswordMissingSpecial:
                  summary: В пароле отсутствует специальный символ
                  value:
                    - >-
                      Password must contain at least one special character
                      (!@#$%^&*()_+-=[]{}|;:,.<>?).
                Duplicate:
                  summary: Для этого адреса электронной почты уже есть аккаунт
                  value:
                    detail: An account with this email already exists.
                EmailUndeliverable:
                  summary: >-
                    Адрес не может принимать электронную почту (одноразовый
                    домен)
                  value:
                    detail: >-
                      This email can't receive messages. Please use a different
                      email address.
                    code: email_undeliverable
                    reason: disposable_domain
                EmailLikelyTypo:
                  summary: Вероятная опечатка в домене
                  value:
                    detail: >-
                      This email can't receive messages. Please use a different
                      email address.
                    code: email_undeliverable
                    reason: possible_typo
                    suggestion: gmail.com
        '429':
          description: >-
            Лимит запросов исчерпан. Более 5 попыток регистрации с одного IP за
            последний час или исчерпан часовой лимит для сети вызывающей стороны
            (/24 для IPv4, /64 для IPv6, общий для регистрации и повторной
            отправки кодов). В обоих случаях возвращается заголовок
            `Retry-After: 3600`. Также возвращается с заголовком `Retry-After:
            5`, когда сервис временно проверяет максимально возможное количество
            паролей или кодов одновременно; повторите попытку через указанное
            количество секунд.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitError'
              examples:
                RateLimited:
                  value:
                    detail: Too many registration attempts. Please try again later.
                PasswordChecksBusy:
                  summary: Слишком много проверок пароля выполняется одновременно
                  value:
                    detail: >-
                      Too many sign-in attempts are being processed right now.
                      Please try again in a few seconds.
      security:
        - {}
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl -X POST https://apx.didit.me/auth/v2/programmatic/register/ \
              -H "Content-Type: application/json" \
              -d '{
                "email": "you@yourdomain.com",
                "password": "MyStr0ng!Pass"
              }'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # This call needs no API key.
            client = Didit()

            result = client.account.register(
                email="you@yourdomain.com",
                password="MyStr0ng!Pass",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // This call needs no API key.
            const didit = new Didit();

            const result = await didit.account.register({
              email: "you@yourdomain.com",
              password: "MyStr0ng!Pass",
            });
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// This call needs no API key.\nclient := didit.NewClient()\n\nresult, err := client.Account.Register(ctx, didit.RegisterRequest{\n\tEmail:    \"you@yourdomain.com\",\n\tPassword: \"MyStr0ng!Pass\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: |-
            import me.didit.Didit;
            import me.didit.types.RegisterRequest;

            // This call needs no API key.
            Didit client = new Didit();

            var result = client.account().register(RegisterRequest.builder()
                    .email("you@yourdomain.com")
                    .password("MyStr0ng!Pass")
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // This call needs no API key.
            $didit = new DiditClient();

            $result = $didit->account->register([
                'email' => 'you@yourdomain.com',
                'password' => 'MyStr0ng!Pass',
            ]);
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # This call needs no API key.
            didit = Didit::Client.new

            result = didit.account.register(
              email: "you@yourdomain.com",
              password: "MyStr0ng!Pass"
            )
            puts result.to_h
        - lang: csharp
          label: .NET
          source: |-
            using System;
            using System.Text.Json;
            using Didit;

            // This call needs no API key.
            using var client = new DiditClient();

            var result = await client.Account.RegisterAsync(new RegisterRequest
            {
                Email = "you@yourdomain.com",
                Password = "MyStr0ng!Pass",
            });
            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    RegisterRequest:
      type: object
      required:
        - email
        - password
      properties:
        email:
          type: string
          format: email
          description: >-
            Любой действительный адрес электронной почты (личный, рабочий,
            псевдоним). Используется как уникальный идентификатор аккаунта.
          example: you@yourdomain.com
        password:
          type: string
          minLength: 8
          description: >-
            Минимум 8 символов. Должен содержать как минимум одну заглавную
            букву (`A-Z`), одну строчную букву (`a-z`), одну цифру (`0-9`) и
            один специальный символ из `!@#$%^&*()_+-=[]{}|;:,.<>?`. Валидация
            сообщает об одном нарушенном правиле за раз.
          example: MyStr0ng!Pass
    RegisterResponse:
      type: object
      properties:
        message:
          type: string
          description: Понятное подтверждение того, что код верификации был отправлен.
          example: Registration successful. Check your email for the verification code.
        email:
          type: string
          format: email
          description: Адрес электронной почты, на который был отправлен код верификации.
          example: you@yourdomain.com
    ValidationError:
      description: >-
        Тело ошибки валидации. Предполагаемый формат обёртки представляет собой
        словарь `{field: ["message", ...]}` для ошибок на уровне полей или
        одноключевую обёртку `{detail: "..."}` для ошибок бизнес-правил.
        Некоторые валидаторы (стойкость пароля при регистрации, действительность
        кода при verify-email) в настоящее время возвращают простой массив
        `["message"]` (известная несогласованность на стороне сервера). Схема
        ниже сохраняет эту ветку с простым массивом, чтобы клиентский код,
        сгенерированный из этой спецификации, мог десериализовать текущие
        ответы, однако новому клиентскому коду следует обрабатывать её в формате
        с ключом соответствующего поля (`{password: [...]}` или `{code:
        [...]}`), и контракт сервера со временем придёт к этому виду.
      oneOf:
        - type: object
          additionalProperties:
            type: array
            items:
              type: string
          example:
            email:
              - Enter a valid email address.
        - type: object
          properties:
            detail:
              type: string
          example:
            detail: An account with this email already exists.
        - type: array
          items:
            type: string
          example:
            - Invalid or expired verification code.
    EmailUndeliverableError:
      type: object
      description: >-
        Возвращается при вызове `POST /programmatic/register/`, когда адрес не
        может получить проверочный код. Проверка выполняется до создания или
        изменения какой-либо учётной записи, поэтому никаких остаточных данных
        не сохраняется.
      required:
        - detail
        - code
        - reason
      properties:
        detail:
          type: string
          description: Понятное сообщение.
          example: >-
            This email can't receive messages. Please use a different email
            address.
        code:
          type: string
          enum:
            - email_undeliverable
          description: Всегда `email_undeliverable`.
        reason:
          type: string
          enum:
            - invalid_address
            - reserved_domain
            - no_mail_records
            - disposable_domain
            - possible_typo
            - suppressed
          description: >-
            Причина отклонения адреса: `invalid_address` (некорректный адрес),
            `reserved_domain` (зарезервированный или тестовый домен, например
            `example.com`), `no_mail_records` (у домена нет почтового сервера),
            `disposable_domain` (сервис одноразовых почтовых ящиков),
            `possible_typo` (вероятная опечатка в имени популярного провайдера;
            см. `suggestion`), `suppressed` (по этому адресу ранее были возвраты
            писем или жалобы).
        suggestion:
          type: string
          description: >-
            Предполагаемый домен, присутствует только тогда, когда домен похож
            на опечатку (например, `gmail.com` вместо `gmial.com`). API не
            принимает подтверждение: зарегистрируйтесь снова с исправленным
            адресом.
          example: gmail.com
    RateLimitError:
      type: object
      description: >-
        Ответ о превышении лимита запросов или прогрессивной блокировке. `wait`
        указывает время ожидания в секундах.
      properties:
        detail:
          type: string
          example: >-
            Too many login attempts from this IP address. Please wait before
            trying again.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.