Saltar al contenido principal
PUT
/
company
/
signer-terms
/
{language}
@firma-dev/sdk
import { FirmaClient } from "@firma-dev/sdk";

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

const response = await firma.signerTerms.updateCompanySignerTerms({
    language: "en",
    statement_text: "statement_text"
});
console.log(response);
curl --request PUT \
--url https://api.firma.dev/functions/v1/signing-request-api/company/signer-terms/{language} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"statement_text": "<string>",
"terms_url": "<string>"
}
'
import requests

url = "https://api.firma.dev/functions/v1/signing-request-api/company/signer-terms/{language}"

payload = {
"statement_text": "<string>",
"terms_url": "<string>"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'PUT',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({statement_text: '<string>', terms_url: '<string>'})
};

fetch('https://api.firma.dev/functions/v1/signing-request-api/company/signer-terms/{language}', 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/company/signer-terms/{language}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'statement_text' => '<string>',
'terms_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);

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

curl_close($curl);

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

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

func main() {

url := "https://api.firma.dev/functions/v1/signing-request-api/company/signer-terms/{language}"

payload := strings.NewReader("{\n \"statement_text\": \"<string>\",\n \"terms_url\": \"<string>\"\n}")

req, _ := http.NewRequest("PUT", url, payload)

req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")

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

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

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.put("https://api.firma.dev/functions/v1/signing-request-api/company/signer-terms/{language}")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"statement_text\": \"<string>\",\n \"terms_url\": \"<string>\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.firma.dev/functions/v1/signing-request-api/company/signer-terms/{language}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"statement_text\": \"<string>\",\n \"terms_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "ok": true,
  "storedHtml": "<string>",
  "changed": true
}
{
"error": "Validation Error",
"message": "Invalid input data",
"details": {
"name": "Name is required",
"email": "Invalid email format"
}
}
{
"error": "Unauthorized",
"message": "Invalid API key"
}
{
"error": "Forbidden",
"message": "You do not have permission to access this resource"
}
{
"error": "Rate Limit Exceeded",
"message": "Too many requests. Please wait before retrying.",
"details": {
"retry_after": 45
}
}

Autorizaciones

Authorization
string
header
requerido

Clave API para autenticación. Usa tu clave API directamente sin ningún prefijo (por ejemplo, 'your-api-key'). El prefijo Bearer es opcional pero no obligatorio.

Parámetros de ruta

language
enum<string>
requerido

Código de idioma

Opciones disponibles:
en,
es,
it,
pt,
fr,
de,
el,
ru,
pl

Cuerpo

application/json
statement_text
string
requerido

Texto de consentimiento del firmante en HTML. Se sanitiza antes de guardarse.

terms_url
string<uri> | null

Enlace externo opcional a los términos

Respuesta

Términos del firmante de la empresa actualizados exitosamente

Resultado de la actualización de términos del firmante

ok
boolean
requerido
storedHtml
string

El HTML saneado que realmente se almacenó

changed
boolean

Indica si el saneamiento alteró la declaración enviada