> ## 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. # مشاركة الجلسة عبر API: إنشاء رمز المشاركة > أنشئ رمز مشاركة مؤقتاً لـ KYC القابل لإعادة الاستخدام عبر POST /v3/session/{id}/share/ من Didit. موقّع بـ JWT، بالدفع لكل استدعاء، دون عقود. موجّه مشاركة الجلسة نسخ الموجّه إلى الحافظة \

\`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` مع نوعي الجلسات، وينشئ token مشاركة JWT يتضمن:```json theme={null} { "session_id": "...", "session_kind": "user" | "business", "from_application_id": "...", "for_application_id": "...", "iat": ..., "exp": ... } ```عندما يستورد الشريك المستلم الـtoken، يقوم 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/ar/sessions-api/share-session/import.md) - [دليل KYC القابل لإعادة الاستخدام](https://docs.didit.me/ar/core-technology/reusable-kyc/share-kyc-via-api.md) - [نظرة عامة على الجلسات](https://docs.didit.me/ar/sessions-api/overview.md) ## OpenAPI ````yaml ar/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: إنشاء token مشاركة لجلسة تحقق مكتملة 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` (ساعة واحدة). minimum: 60 maximum: 86400 default: 3600 example: 3600 example: for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee ttl_in_seconds: 7200 responses: '200': description: تم إصدار token المشاركة. 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: >- بيانات اعتماد مفقودة أو غير صالحة. على عكس معظم الـ endpoints في الإصدار v3، يقوم هذا الـ endpoint بالمصادقة من خلال الـ decorator الخاص بالأذونات ويُرجع `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 الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.