> ## 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 de imagem de assinatura: PNG da assinatura adotada > Com a API da Didit, baixe em PNG a assinatura ou as iniciais que um signatário aplicou a um campo de um documento de assinatura eletrônica. Retorna, em PNG, a assinatura ou as iniciais que um signatário aplicou a um campo. O caminho está no `image_url` do campo, em `signatures[].documents[].fields[]`, então você não precisa montá-lo. É necessária a permissão `read:sessions`. ```bash theme={null} curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/fields/{field_id}/image/' \ -H 'x-api-key: YOUR_API_KEY' \ -o signature.png ``` Uma assinatura desenhada é a imagem que o signatário desenhou, e é essa imagem que é carimbada no PDF assinado. Uma assinatura digitada é o nome verificado do signatário no estilo de caligrafia que ele escolheu, e o PDF assinado a contém como texto nesse mesmo estilo. Como prova da assinatura em si, use o [documento assinado](https://docs.didit.me/pt-br/sessions-api/electronic-signature/download-signed-document.md) e as [evidências](https://docs.didit.me/pt-br/sessions-api/electronic-signature/download-evidence.md). Um campo que não pertence ao signatário, ou que não tem assinatura ou iniciais aplicadas, retorna `404` com `signature_field_not_found`. Uma imagem armazenada cujo SHA-256 não corresponde mais ao registrado retorna `400` com `signature_document_changed`. Depois que você [exclui a sessão](https://docs.didit.me/pt-br/sessions-api/delete-session.md), a rota retorna `404`. ## Relacionados * [Campos no documento](https://docs.didit.me/pt-br/core-technology/electronic-signature/overview.md#campos-no-documento) * [Relatório de assinatura eletrônica](https://docs.didit.me/pt-br/core-technology/electronic-signature/report-electronic-signature.md#campos) ## OpenAPI ````yaml pt-br/openapi-25.json GET /v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificação de identidade. Autentique-se com o cabeçalho x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/: get: tags: - Sessions summary: Baixar a imagem de uma assinatura description: >- Baixe, em PNG, a assinatura ou as iniciais que um signatário aplicou a um campo. Use o `image_url` do campo em `signatures[].documents[].fields[]`. Requer `read:sessions`; sua chave de API funciona. operationId: get_v3_session_signature_field_image parameters: - name: sessionId in: path required: true description: >- A sessão de Verificação de usuários (KYC) ou de Verificação de empresas (KYB). schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: nodeId in: path required: true description: >- A etapa de Assinatura eletrônica: `node_id` do item em `signatures[]`. schema: type: string example: feature_signature - name: fieldId in: path required: true description: O campo na cópia deste signatário, como no `image_url` do campo. schema: type: string format: uuid responses: '200': description: A imagem. content: image/png: schema: type: string format: binary '400': description: A imagem armazenada não corresponde mais ao SHA-256 registrado. content: application/json: schema: type: object properties: detail: type: string code: type: string example: code: signature_document_changed detail: signature_document_changed '403': description: >- Credenciais ausentes, ou uma credencial que não pode ler esta sessão. Uma chave ausente retorna `403`; uma chave incorreta, revogada ou expirada retorna `401`. content: application/json: schema: type: object properties: detail: type: string example: detail: You do not have permission to perform this action. '404': description: >- Nenhuma imagem corresponde: a sessão, a etapa ou o campo não existe, foi excluído ou não tem assinatura ou rubrica aplicada. content: application/json: schema: type: object properties: detail: type: string code: type: string examples: Unknown field: summary: Campo não encontrado value: code: signature_field_not_found detail: signature_field_not_found security: - ApiKeyAuth: [] x-codeSamples: - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() content = client.sessions.signatures.download_field_image( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ) with open("download.png", "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.downloadFieldImage( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555", ); await writeFile("download.png", 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.DownloadFieldImage(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.png\")\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().downloadFieldImage("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555") .writeTo(Path.of("download.png")); - lang: php label: PHP source: >- sessions->signatures->downloadFieldImage('11111111-2222-3333-4444-555555555555', 'feature_signature', '11111111-2222-3333-4444-555555555555'); $content->saveTo('download.png'); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new content = didit.sessions.signatures.download_field_image( "11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555" ) File.binwrite("download.png", 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.DownloadFieldImageAsync("11111111-2222-3333-4444-555555555555", "feature_signature", "11111111-2222-3333-4444-555555555555"); await content.SaveToAsync("download.png"); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.