> ## 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. # Скачать подписанный PDF через API электронной подписи > Скачайте подписанный PDF одного документа из шага электронной подписи для сессии KYC или KYB с помощью вашего API-ключа Didit. Возвращает подписанный PDF одного документа после того, как подписант его подписал. Формировать URL самостоятельно не нужно: путь к каждому подписанному документу в решении указан в `signatures[].documents[].signed_file`. ```bash theme={null} curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/documents/{document_id}/file/' \ -H 'x-api-key: YOUR_API_KEY' \ -o agreement-signed.pdf ``` PDF содержит документ, который был показан подписанту, со вписанными значениями его полей, и страницу с доказательствами (если у шага не выключен параметр `signature_evidence_page`). PDF уровня Advanced (AES) также содержит подпись PAdES с меткой времени. PDF уровня Simple не содержит цифровой подписи, печати или метки времени. Перед возвратом файла Didit сверяет сохранённый файл с `sha256_signed`. Если значения не совпадают, возвращается `409` с `signature_document_changed`. Документ, который ещё не подписан, возвращает `404` с `signature_not_signed`. После того как вы [удалите сессию](https://docs.didit.me/ru/sessions-api/delete-session.md), этот маршрут возвращает `404`. ## Связанные материалы * [Отчёт по электронной подписи](https://docs.didit.me/ru/core-technology/electronic-signature/report-electronic-signature.md#подписанный-pdf): что содержит подписанный PDF. * [Скачать доказательства подписи](https://docs.didit.me/ru/sessions-api/electronic-signature/download-evidence.md) * [Проверка подписей](https://docs.didit.me/ru/sessions-api/electronic-signature/validate-signatures.md) ## OpenAPI ````yaml ru/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/documents/{documentId}/file/ 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}/signatures/{nodeId}/documents/{documentId}/file/: get: tags: - Sessions summary: Скачать подписанный документ description: >- Скачать подписанный PDF-файл одного документа из шага «Электронная подпись». Используйте путь `signed_file` в `signatures[].documents[]` в решении. PDF содержит документ, показанный подписанту, с проставленными значениями полей и страницей с доказательствами (если не отключён параметр `signature_evidence_page`). PDF с усиленной подписью (AES) также содержит подпись PAdES с меткой времени; простой PDF не содержит цифровой подписи, печати или метки времени. Didit сверяет файл с `sha256_signed` перед его возвратом. Работает для сессий проверки пользователей (KYC) и верификации бизнеса (KYB). Требуется `read:sessions`; ваш API-ключ подходит. См. [отчёт об электронной подписи](/ru/core-technology/electronic-signature/report-electronic-signature#скачивание-подписанных-документов). operationId: get_v3_session_signature_document_file parameters: - name: sessionId in: path required: true description: Сессия проверки пользователей (KYC) или верификации бизнеса (KYB). schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: nodeId in: path required: true description: 'Шаг «Электронная подпись»: `node_id` элемента в `signatures[]`.' schema: type: string example: feature_signature - name: documentId in: path required: true description: '`id` документа в `signatures[].documents[]`.' schema: type: string format: uuid responses: '200': description: Подписанный PDF. headers: Content-Disposition: description: Вложение с именем файла. schema: type: string example: attachment; filename="agreement-signed.pdf" content: application/pdf: schema: type: string format: binary '403': description: >- Отсутствуют учетные данные или используются учетные данные, не позволяющие прочитать эту сессию. При отсутствии ключа возвращается `403`; при неверном, отозванном или истекшем ключе возвращается `401`. content: application/json: schema: type: object properties: detail: type: string example: detail: You do not have permission to perform this action. '404': description: >- Подходящий подписанный документ не найден: сессия, шаг или документ не существуют, были удалены или ещё не подписаны. content: application/json: schema: type: object properties: detail: type: string code: type: string examples: Not signed yet: summary: Подписант ещё не подписал value: code: signature_not_signed detail: signature_not_signed Unknown document: summary: Такой документ отсутствует в этом шаге value: code: signature_not_found detail: signature_not_found '409': description: >- Сохранённый файл больше не совпадает с записанным значением SHA-256. Ничего не возвращено. content: application/json: schema: type: object properties: detail: type: string code: type: string examples: Changed file: summary: Сохраненный файл не соответствует своему хешу value: code: signature_document_changed detail: signature_document_changed security: - ApiKeyAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() content = client.sessions.signatures.download_document( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ) with open("download.pdf", "wb") as file: file.write(content) - lang: javascript label: Node.js source: >- import { writeFile } from "node:fs/promises"; import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const content = await didit.sessions.signatures.downloadDocument( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ); await writeFile("download.pdf", Buffer.from(await content.arrayBuffer())); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresp, err := client.Sessions.Signatures.DownloadDocument(ctx, \"11111111-2222-3333-4444-555555555555\", \"feature_signature\", \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer resp.Body.Close()\nfile, err := os.Create(\"download.pdf\")\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer file.Close()\nif _, err := io.Copy(file, resp.Body); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import java.nio.file.Path; import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); client.sessions().signatures().downloadDocument("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555") .writeTo(Path.of("download.pdf")); - lang: php label: PHP source: >- sessions->signatures->downloadDocument('11111111-2222-3333-4444-555555555555', 'feature_signature', '11111111-2222-3333-4444-555555555555'); $content->saveTo('download.pdf'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new content = didit.sessions.signatures.download_document( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555" ) File.binwrite("download.pdf", content) - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var content = await client.Sessions.Signatures.DownloadDocumentAsync("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555"); await content.SaveToAsync("download.pdf"); 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.