> ## 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. # Share Session API: токен общего доступа > POST /v3/session/{id}/share/ создаёт временный токен общего доступа для многоразового KYC или KYB. JWT, без контрактов, оплата за вызов в Didit. Промпт для предоставления сессии Скопировать промпт в буфер обмена \

\`Mint a short-lived share token so another Didit application can import this finished verification session (Reusable KYC / KYB).

Endpoint:
POST https://verification.didit.me/v3/session/{session_id}/share/

Authentication:
Use the x-api-key header with your Didit API key. Privilege: write:sessions.

Path parameter:
\- session_id (UUID) — works for both User Verification (KYC) and Business Verification (KYB).

Request body:
\- for_application_id (string, UUID, required) — UUID of the receiving Didit application. Must exist, must not be deleted, and must be different from the calling application.
\- ttl_in_seconds (integer, optional, default 3600) — Lifetime of the share token. Min 60, max 86400 (24 hours).

Prerequisites:
\- Session status must be one of "Approved", "Declined", "In Review". Any other status returns 400 ("Only finished sessions ... can be shared.").

curl example:
curl -X POST https://verification.didit.me/v3/session//share/ \
-H "x-api-key: " \
-H "Content-Type: application/json" \
-d '{
"for_application_id": "",
"ttl_in_seconds": 3600
}'

Response:
\- share_token (string) — HS256-signed JWT with payload { session_id, session_kind, from_application_id, for_application_id, iat, exp }.
\- for_application_id (UUID) — echoed back.
\- session_kind ("user" | "business") — embedded so the receiver clones the right kind.

Token characteristics:
\- Bound to for_application_id — only that application can redeem it via POST /v3/session/import-shared/.
\- Cannot be revoked via API — it simply expires after ttl_in_seconds.
\- You can mint multiple tokens for the same session (e.g. one per partner). Each call returns a fresh JWT with a new iat.

Failure modes:
\- 400 — { "detail": "Only finished sessions ... can be shared." } when the session isn't Approved/Declined/In Review.
\- 400 — { "for_application_id": ["..."] } for unknown or self application UUIDs.
\- 401 — invalid API key.
\- 403 — { "detail": "You do not have permission to perform this action." } when the key lacks write:sessions.
\- 404 — { "detail": "Not found." } when the session_id is not visible to this application.

Send the share_token to the receiving partner through your own secure channel (HTTPS API call, webhook, signed email link, etc.).

Next step:
The receiving application calls POST https://verification.didit.me/v3/session/import-shared/ with the share_token to clone the session — see /sessions-api/share-session/import.

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

\
Вставьте в ## Поддержка KYC и KYBРаботает для сессий **Проверки пользователей (KYC)** и **Верификации бизнеса (KYB)**. Didit сопоставляет `session_id` с обоими типами сессий и генерирует JWT token общего доступа, который включает:```json theme={null} { "session_id": "...", "session_kind": "user" | "business", "from_application_id": "...", "for_application_id": "...", "iat": ..., "exp": ... } ```Когда принимающий партнёр импортирует токен, Didit клонирует соответствующую сессию (KYC или KYB) вместе с её связями.## Требования- Сессия должна быть в завершённом статусе (`APPROVED`, `DECLINED`, `IN_REVIEW`). - У вас должна быть привилегия `write:sessions`. - `for_application_id` должен быть действительным приложением Didit (обычно приложением партнёра).## Примеры> [tab] Поделиться сессией Проверки пользователей (KYC) > > ```bash theme={null} > curl -X POST https://verification.didit.me/v3/session/4c5c7f3a-.../share/ \ > -H "x-api-key: YOUR_API_KEY" \ > -H "Content-Type: application/json" \ > -d '{ > "for_application_id": "partner-app-uuid", > "ttl_in_seconds": 3600 > }' > ``` > > **Ответ:** > > ```json theme={null} > { > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "for_application_id": "partner-app-uuid", > "session_kind": "user" > } > ```> [tab] Поделиться сессией Верификации бизнеса (KYB) > > ```bash theme={null} > curl -X POST https://verification.didit.me/v3/session/bs-01HJX1.../share/ \ > -H "x-api-key: YOUR_API_KEY" \ > -H "Content-Type: application/json" \ > -d '{ > "for_application_id": "partner-app-uuid", > "ttl_in_seconds": 7200 > }' > ``` > > **Ответ:** > > ```json theme={null} > { > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "for_application_id": "partner-app-uuid", > "session_kind": "business" > } > ```## Границы TTL| Параметр | Минимум | Максимум | По умолчанию | | - | - | - | - | | `ttl_in_seconds` | 60 | 86400 | 3600 |## Связанные материалы- [Импорт общей сессии](https://docs.didit.me/ru/sessions-api/share-session/import.md) - [Руководство по многоразовому KYC](https://docs.didit.me/ru/core-technology/reusable-kyc/share-kyc-via-api.md) - [Обзор сессий](https://docs.didit.me/ru/sessions-api/overview.md) ## OpenAPI ````yaml ru/openapi-25.json POST /v3/session/{sessionId}/share/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/share/: post: tags: - Sessions summary: Сгенерировать токен общего доступа для завершённой сессии верификации description: >- Сгенерировать короткоживущий JWT, позволяющий конкретному приложению Didit импортировать эту завершённую сессию. Используется в паре с `POST /v3/session/import-shared/`. operationId: post_v3_session_share parameters: - in: path name: sessionId required: true description: UUID исходной сессии верификации, для которой выпускается token. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 requestBody: required: true content: application/json: schema: type: object required: - for_application_id properties: for_application_id: type: string format: uuid description: >- UUID приложения Didit, которое погасит token. Оно должно существовать, не быть удалено и отличаться от вызывающего приложения. Его можно найти в Business Console в разделе **Settings → Application**. example: a5f3bca2-46e2-411e-90ef-a580900a57ee ttl_in_seconds: type: integer description: >- Срок действия token в секундах. Минимум `60`, максимум `86400` (24 ч). По умолчанию `3600` (1 ч). minimum: 60 maximum: 86400 default: 3600 example: 3600 example: for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee ttl_in_seconds: 7200 responses: '200': description: Выпущен токен доступа. content: application/json: schema: type: object properties: share_token: type: string description: >- JWT с подписью HS256. Передайте это значение без изменений в качестве `share_token` в [`POST /v3/session/import-shared/`](/sessions-api/import-shared-session) в целевом приложении. example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... for_application_id: type: string format: uuid description: >- Возвращает эхо UUID целевого приложения, к которому привязан token. example: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: type: string enum: - user - business description: >- Является ли исходная сессия сессией Проверки пользователей (KYC) или Верификации бизнеса (KYB). examples: User session: summary: Поделиться сессией KYC value: share_token: >- eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uX2lkIjoiMjBiYjNjM2ItNjE0Ni00MzlmLTg0YTQtYmQzMGQwMGFjNmEyIiwiZnJvbV9hcHBsaWNhdGlvbl9pZCI6ImRiZDIwZTM0LTQyZTktNGYyYy1iYTkxLWNmMDc2MjAxNmY2NCIsImZvcl9hcHBsaWNhdGlvbl9pZCI6ImE1ZjNiY2EyLTQ2ZTItNDExZS05MGVmLWE1ODA5MDBhNTdlZSIsImlhdCI6MTc1MzYzMDY2NiwiZXhwIjoxNzUzNjM0MjY2fQ.JJ9pNE_hqZsOtbR0XYZIWw4JzidjdEl279iUrsIkhGE for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: user Business session: summary: Поделиться сессией KYB value: share_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: business '400': description: >- Ошибка валидации. Ошибки полей сгруппированы по именам полей; ошибка о незавершенности возвращается под ключом `detail` (в виде массива). content: application/json: examples: Wrong status: summary: Исходная сессия не завершена value: detail: - >- Only finished sessions ("Approved", "Declined", "In Review") can be shared. Target missing: summary: Целевое приложение не существует value: for_application_id: - Target application does not exist. Self-share: summary: Целевым объектом является вызывающее приложение value: for_application_id: - Cannot share a session with the same application. TTL bounds: summary: ttl_in_seconds выходит за допустимые пределы value: ttl_in_seconds: - Ensure this value is greater than or equal to 60. '401': description: >- Отсутствуют или недействительны учетные данные. В отличие от большинства endpoint v3, этот endpoint выполняет аутентификацию через декоратор разрешений и возвращает `401`, если не предоставлен действительный token/ключ. content: application/json: examples: Unauthorized: summary: Не авторизован value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- Учетные данные действительны, но не имеют разрешения `write:sessions` для этого приложения. content: application/json: examples: No Permission: summary: Нет разрешения value: detail: You do not have permission to perform this action. '404': description: Сессия с указанным `session_id` не существует в вашем приложении. content: application/json: examples: Not Found: summary: Сессия не найдена value: detail: Not found. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST \ https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/share/ \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "for_application_id": "a5f3bca2-46e2-411e-90ef-a580900a57ee", "ttl_in_seconds": 7200 }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.share( "11111111-2222-3333-4444-555555555555", for_application_id="a5f3bca2-46e2-411e-90ef-a580900a57ee", ttl_in_seconds=7200, ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.share("11111111-2222-3333-4444-555555555555", { for_application_id: "a5f3bca2-46e2-411e-90ef-a580900a57ee", ttl_in_seconds: 7200, }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.Share(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SessionsShareParams{\n\tForApplicationID: \"a5f3bca2-46e2-411e-90ef-a580900a57ee\",\n\tTTLInSeconds: didit.Int(7200),\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.SessionsShareParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().share("11111111-2222-3333-4444-555555555555", SessionsShareParams.builder() .forApplicationId("a5f3bca2-46e2-411e-90ef-a580900a57ee") .ttlInSeconds(7200L) .build()); System.out.println(result); - lang: php label: PHP source: >- sessions->share('11111111-2222-3333-4444-555555555555', [ 'for_application_id' => 'a5f3bca2-46e2-411e-90ef-a580900a57ee', 'ttl_in_seconds' => 7200, ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.share( "11111111-2222-3333-4444-555555555555", for_application_id: "a5f3bca2-46e2-411e-90ef-a580900a57ee", ttl_in_seconds: 7200 ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.ShareAsync("11111111-2222-3333-4444-555555555555", new SessionsShareParams { ForApplicationId = "a5f3bca2-46e2-411e-90ef-a580900a57ee", TtlInSeconds = 7200, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.