Do sandbox ao primeiro envio, na sua linguagem

# 1. Envie o PDF
curl -X POST \
  https://sandbox.assinafy.com.br/v1/accounts/{account_id}/documents \
  -H 'X-Api-Key: {api_key}' \
  -F 'file=@contrato.pdf'

# 2. Cadastre quem assina
curl -X POST \
  https://sandbox.assinafy.com.br/v1/accounts/{account_id}/signers \
  -H 'X-Api-Key: {api_key}' \
  -H 'Content-Type: application/json' \
  -d '{"full_name": "João Silva", "email": "joao@exemplo.com.br"}'

# 3. Peça a assinatura
curl -X POST \
  https://sandbox.assinafy.com.br/v1/documents/{document_id}/assignments \
  -H 'X-Api-Key: {api_key}' \
  -H 'Content-Type: application/json' \
  -d '{"method": "virtual", "signers": [{"id": "{signer_id}"}], "message": "Por favor, assine este contrato"}'

# Instalação
npm install @assinafy/sdk

# Uso
import { AssinafyClient } from '@assinafy/sdk';

const client = new AssinafyClient({
  apiKey: process.env.ASSINAFY_API_KEY!,
  accountId: process.env.ASSINAFY_ACCOUNT_ID!,
});

const resultado = await client.uploadAndRequestSignatures({
  source: { filePath: './contrato.pdf' },
  signers: [
    { name: 'João Silva', email: 'joao@exemplo.com.br' },
  ],
  message: 'Por favor, assine este contrato',
});

# Instalação
pip install assinafy

# Uso
import os
from assinafy import AssinafyClient

with AssinafyClient(
    api_key=os.environ["ASSINAFY_API_KEY"],
    account_id=os.environ["ASSINAFY_ACCOUNT_ID"],
) as client:
    resultado = client.upload_and_request_signatures(
        source={"file_path": "./contrato.pdf"},
        signers=[
            {"full_name": "João Silva", "email": "joao@exemplo.com.br"},
        ],
        message="Por favor, assine este contrato",
    )

# Instalação
composer require assinafy/php-sdk

# Uso
use Assinafy\SDK\AssinafyClient;

$client = AssinafyClient::create(
    apiKey: (string) getenv('ASSINAFY_API_KEY'),
    accountId: (string) getenv('ASSINAFY_ACCOUNT_ID'),
);

$result = $client->uploadAndRequestSignatures(
    filePath: '/caminho/absoluto/contrato.pdf',
    signers: [['full_name' => 'João Silva', 'email' => 'joao@exemplo.com.br']],
    message: 'Por favor, assine este contrato',
);

# Instalação
gem install assinafy

# Uso
require 'assinafy'

client = Assinafy::Client.new(
  api_key:    ENV.fetch('ASSINAFY_API_KEY'),
  account_id: ENV.fetch('ASSINAFY_ACCOUNT_ID')
)

resultado = client.upload_and_request_signatures(
  source:  './contrato.pdf',
  signers: [{ full_name: 'João Silva', email: 'joao@exemplo.com.br' }],
  message: 'Por favor, assine este contrato'
)

# Instalação
go get github.com/assinafy/golang-sdk

// Uso
client, err := assinafy.NewClient(assinafy.ClientOptions{
	APIKey:    os.Getenv("ASSINAFY_API_KEY"),
	AccountID: os.Getenv("ASSINAFY_ACCOUNT_ID"),
})
if err != nil {
	log.Fatal(err)
}

pdf, _ := os.ReadFile("contrato.pdf")
resultado, err := client.UploadAndRequestSignatures(ctx, pdf, "contrato.pdf",
	[]models.UploadAndRequestSignaturesSigner{
		{Name: "João Silva", Email: "joao@exemplo.com.br"},
	},
	"Por favor, assine este contrato", nil, "")

# Instalação
cargo add assinafy

// Uso
let conta = std::env::var("ASSINAFY_ACCOUNT_ID").unwrap();
let client = Client::builder()
    .api_key(std::env::var("ASSINAFY_API_KEY").unwrap())
    .build()?;

let signatario = client.signers(&conta)
    .create(&CreateSignerBody::new("João Silva").email("joao@exemplo.com.br"))
    .await?;

let arquivo = UploadDocumentRequest::from_path("./contrato.pdf").await?;
let documento = client.documents().upload(&conta, arquivo).await?;
// aguarde o status metadata_ready (exemplo completo no README)

let pedido = CreateAssignmentBody::new(AssignmentMethod::Virtual, [signatario.id.as_str()])
    .message("Por favor, assine este contrato");
let resultado = client.assignments().create(&documento.id, &pedido).await?;

# Instalação
dotnet add package Assinafy.Sdk

// Uso
using var client = new AssinafyClient(new AssinafyClientOptions
{
    ApiKey = Environment.GetEnvironmentVariable("ASSINAFY_API_KEY"),
    AccountId = Environment.GetEnvironmentVariable("ASSINAFY_ACCOUNT_ID"),
});

await using var pdf = File.OpenRead("contrato.pdf");
var resultado = await client.UploadAndRequestSignaturesAsync(new UploadAndRequestSignaturesOptions
{
    FileStream = pdf,
    FileName = "contrato.pdf",
    Message = "Por favor, assine este contrato",
    Signers = [new UploadAndRequestSignaturesSigner
    {
        FullName = "João Silva",
        Email = "joao@exemplo.com.br",
    }],
});

# Instalação (Maven ou Gradle, pelo Maven Central)
com.assinafy:assinafy-sdk

// Uso
AssinafyClient client = AssinafyClient.create(
    System.getenv("ASSINAFY_API_KEY"),
    System.getenv("ASSINAFY_ACCOUNT_ID"));

UploadAndRequestSignaturesResult resultado = client.uploadAndRequestSignatures(
    UploadAndRequestSignaturesRequest.builder()
        .fileData(Files.readAllBytes(Path.of("contrato.pdf")))
        .fileName("contrato.pdf")
        .signers(List.of(
            UploadAndRequestSignaturesRequest.SignerEntry.builder()
                .name("João Silva")
                .email("joao@exemplo.com.br")
                .build()))
        .message("Por favor, assine este contrato")
        .build());

# Instalação
git clone https://github.com/assinafy/object-pascal-sdk.git

// Uso (resumido; liberação de memória no README)
AccountID := GetEnvironmentVariable('ASSINAFY_ACCOUNT_ID');
Client := TAssinafyClient.Create(
  GetEnvironmentVariable('ASSINAFY_API_KEY'), AccountID, AssinafySandboxURL);

Response := Client.UploadDocument(AccountID, 'contrato.pdf');
DocumentID := JSONString(JSONFind(Response.Data, 'id'));

Response := Client.CreateSigner(AccountID,
  JSONObj(['full_name', 'João Silva', 'email', 'joao@exemplo.com.br']));
SignerID := JSONString(JSONFind(Response.Data, 'id'));

Body := JSONObj(['method', 'virtual', 'message', 'Por favor, assine este contrato']);
Signers := TJSONArray.Create;
JSONAdd(Body, 'signers', Signers);
JSONAdd(Signers, JSONObj(['id', SignerID]));
Response := Client.CreateAssignment(DocumentID, Body);