Passer au contenu principal
GET
/
signing-requests
/
{id}
/
signers
/
{signer_id}
/
stamps
/
{field_id}
@firma-dev/sdk
import { FirmaClient } from "@firma-dev/sdk";

const firma = new FirmaClient({ apiKey: "YOUR_API_KEY" });

const response = await firma.signingRequests.retrieveSignerStamp({
    id: "id",
    signer_id: "signer_id",
    field_id: "field_id"
});
console.log(response);
curl --request GET \
--url https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/stamps/{field_id} \
--header 'Authorization: <api-key>'
import requests

url = "https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/stamps/{field_id}"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/stamps/{field_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/stamps/{field_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/stamps/{field_id}"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/stamps/{field_id}")
.header("Authorization", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/stamps/{field_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "signer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "format": "png",
  "framed": true,
  "image": "data:image/png;base64,iVBORw0KGgo..."
}
{
"error": "<string>",
"code": "<string>"
}
{
"error": "<string>",
"code": "<string>"
}
{
"error": "<string>",
"code": "<string>"
}
{
"error": "<string>",
"code": "<string>"
}
{
"error": "<string>",
"code": "<string>"
}

Autorisations

Authorization
string
header
requis

Clé API pour l'authentification. Utilisez votre clé API directement sans préfixe (par exemple, 'your-api-key'). Le préfixe Bearer est optionnel mais pas obligatoire.

Paramètres de chemin

id
string<uuid>
requis

ID de la demande de signature

signer_id
string<uuid>
requis

ID du signataire (destinataire)

field_id
string<uuid>
requis

ID du champ de tampon

Paramètres de requête

include_frame
boolean
défaut:true

Superposer le cadre d'identification du signataire sur l'image (true par défaut). Réglez sur false pour la marque brute.

Réponse

La marque du signataire sous forme d'URI de données PNG en base64.

signer_id
string<uuid>
kind
enum<string>
Options disponibles:
signature,
initials,
stamp
format
string
Exemple:

"png"

framed
boolean

Indique si le cadre d'identification du signataire a été superposé.

image
string

PNG sous forme d'URI de données.

Exemple:

"data:image/png;base64,iVBORw0KGgo..."