Documentação

Guia completo para integrar e utilizar a API de assinatura digital do SimpleSigner.

Introdução

A API SimpleSigner permite assinar documentos PDF digitalmente usando certificados A1 de forma automatizada. A API segue os princípios REST e retorna respostas em JSON.

Base URL: https://www.simplesigner.com.br/

Autenticação

Todas as chamadas de API requerem o header X-Auth-Token.

X-Auth-Token: SEU_TOKEN_AQUI

Assinar Documento (Upload)

Envia um PDF para ser assinado.

POST /Sign/Upload
Parâmetros (Multipart/Form-Data)
CampoTipoDescrição
fileFileArquivo PDF a ser assinado.
Exemplo de Resposta (Sucesso)
{
  "success": true,
  "message": "Arquivo assinado com sucesso",
  "downloadUrl": "https://www.simplesigner.com.br/Sign/DownloadDoc/xyz...",
  "fileName": "documento_assinado.pdf"
}

Upload de Certificado

Atualiza o certificado digital da empresa.

POST /Sign/UploadCertificate
Parâmetros
CampoTipoDescrição
fileFileArquivo .pfx
passwordStringSenha do arquivo .pfx (Query ou Body)

Exemplos de Integração

Veja como chamar a API nas principais linguagens.

using System.Net.Http;
using System.Net.Http.Headers;
using System.IO;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Auth-Token", "SEU_TOKEN");

var form = new MultipartFormDataContent();
var fileContent = new ByteArrayContent(File.ReadAllBytes("documento.pdf"));
fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse("application/pdf");
form.Add(fileContent, "file", "documento.pdf");

var response = await client.PostAsync("https://www.simplesigner.com.br/Sign/Upload", form);
var result = await response.Content.ReadAsStringAsync();
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.simplesigner.com.br/Sign/Upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["X-Auth-Token: SEU_TOKEN"],
  CURLOPT_POSTFIELDS => [
    'file' => new CURLFile('/path/to/documento.pdf')
  ]
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
// Usando OkHttp
OkHttpClient client = new OkHttpClient();

RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
    .addFormDataPart("file", "documento.pdf",
        RequestBody.create(MediaType.parse("application/pdf"), new File("documento.pdf")))
    .build();

Request request = new Request.Builder()
    .url("https://www.simplesigner.com.br/Sign/Upload")
    .addHeader("X-Auth-Token", "SEU_TOKEN")
    .post(body)
    .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());
import requests

url = "https://www.simplesigner.com.br/Sign/Upload"
headers = {"X-Auth-Token": "SEU_TOKEN"}
files = {"file": open("documento.pdf", "rb")}

response = requests.post(url, headers=headers, files=files)
print(response.json())