Run with Postman
Documentation Powered by Redocly

Firma Digitale (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Web service that allows you to purchase or renew Infocert or Aruba digital signatures, and to obtain digital identities.

First time here? Generate a new access token

Firma elettronica

Methods that allows you to digitally sign PDF document with REST APIs.

List all your past and pending requests

Authorizations:
bearerAuth

    Responses

    Response Schema: application/json
    Array of objects (FesBaseResponse) <= 2 items [ items ]
    success
    boolean
    message
    string
    error
    string

    Request samples 

    CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

    Response samples

    Content type
    application/json
    {
    • "data": [
      ],
    • "success": true,
    • "message": "string",
    • "error": "string"
    }

    Get information on a sign request

    Authorizations:
    bearerAuth
      path Parameters
      id
      required
      string
      Default: "<string>"
      Example: 923j90n02n1w51504b6ea145

      Responses

      Response Schema: application/pdf
      object (FesBaseResponse)
      success
      boolean
      message
      string
      error
      string

      Request samples 

      CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

      Download your signed document

      Once the signing process is compleated you can use this endpoint to get a the base64-encoded output of you pdf file.

      Authorizations:
      bearerAuth
        path Parameters
        id
        required
        string
        Default: "<string>"
        Example: 923j90n02n1w51504b6ea145

        Responses

        Response Schema: application/json
        content
        string

        A base64 encoding of your SIGNED pdf file.

        success
        boolean
        message
        string
        error
        string

        Request samples 

        CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica/%7Bid%7D/download");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

        Response samples

        Content type
        application/json
        {
        • "content": "aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==",
        • "success": true,
        • "message": "string",
        • "error": "string"
        }

        Retrieve Audit Trail for Signed Document

        Retrieve the audit trail for the specified electronic signature.

        Parameters

        • id (path parameter): The unique identifier of the signed document.

        Example

        # Download audit trail in JSON format
curl -X GET https://ws.firmadigitale.com/firma_elettronica/923j90n02n1w51504b6ea145/audit


The response will contain the audit trail information for the electronic signature.
        Authorizations:
        bearerAuth
          path Parameters
          id
          required
          string
          Default: "<string>"
          Example: 923j90n02n1w51504b6ea145

          Responses

          Response Schema: application/json
          object
          success
          boolean

          Indicates whether the electronic signature operation was successful.

          message
          string

          A message related to the electronic signature operation.

          error
          object

          Error details related to the electronic signature operation.

          Request samples 

          CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica/%7Bid%7D/audit");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

          Response samples

          Content type
          application/json
          {
          • "data": {
            },
          • "success": true,
          • "message": "",
          • "error": null
          }

          [DEPRECATED] Create a custom UI for e-signatures Deprecated

          This endpoint is deprecated and no longer supported.

          Authorizations:
          bearerAuth
            Request Body schema: application/json
            Schema not provided

            Responses

            Request samples 

            CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica_ui");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "content-type: application/json");
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

            [DEPRECATED] List all your custom UIs Deprecated

            Authorizations:
            bearerAuth

              Responses

              Request samples 

              CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica_ui");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);