Comprobación de una cadena de información

Este método permitirá obtener todas las transacciones enlazadas a partir de una dada. Este método permite comprobar toda la cadena de información y por tanto garantizar la trazabilidad de los datos a partir de una transacción.

Método de la API

El endpoint de la API sobre el que se realiza la llamada es /api/proof/getChain sobre la que se realiza una operación de tipo POST.

Input

Código de transacción del bloque de información: Se enviará el código de transacción de cualquiera de los bloques de información enviado.

• tx: Código de la transacción a partir de la cual queremos conocer toda la cadena de datos.

Ejemplos de envío

CURL

curl https://TRACEMATE-URL/api/proof/getChain
          -X POST 
          -H "Content-Type: application/json" 
          -H "X-Tracemate-APIKey: TRACEMATE-API-KEY"
          -H "X-Tracemate-Locale: TRACEMATE_ISO_CODE"
          --data '{
            "tx": "fc238483ecef71926983ec3ffabd6cdf7bf82be106454e694531c38139f9f7c5",            
            }'
        

Javascript

          import axios from 'axios';
          const response = await axios.post('https://TRACEMATE-URL/api/proof/getChain',
          {
            "tx": "fc238483ecef71926983ec3ffabd6cdf7bf82be106454e694531c38139f9f7c5",            
          } , {
            headers: {
            'Content-Type': 'application/json',
            'X-Tracemate-APIKey': 'TRACEMATE-API-KEY'
            'X-Tracemate-Locale': 'TRACEMATE_ISO_CODE'
          }
         })
        

Python

          import requests   
          url = "https://TRACEMATE-URL/api/proof/getChain"      
          data = {
            "tx": "fc238483ecef71926983ec3ffabd6cdf7bf82be106454e694531c38139f9f7c5",
            }         
          response = requests.post(url, json=data)      
        

caution

Se deberían sustituir las siguientes variables:

• TRACEMATE_URL: Con la URL de Tracemate según el modo de funcionamiento (Por ej: api-test.tracemate.cloud para el entorno de pruebas)
• TRACEMATE-API-KEY: Con la API Key de la licencia de uso.
• TRACEMATE_ISO_CODE: Con el código ISO del idioma con el que se desea operar con Tracemate.

info

El sistema verificará que el código de transacción es válido y pertenece a una cadena del cliente que solicita la llamada a este servicio.

Output

Listado de bloques de información: se enviará un listado con los bloques de información registrados hasta el bloque enviado como input en este servicio.

Ejemplo de respuesta

El sistema enviará la siguiente información de respuesta:

{
    "code": 200,
    "data": {
        "assets": [
            {
                "hash": "322948144e20c69370a3f0707505346fe275f1b5",
                "payload": "{\"data\": \"Texto de prueba\"}",
                "blockchainTX": "e8a63b1881b811c9a376915c491f077a156e350239860c3a20d0fcd30174e30d",
                "confirmations": 3194,
                "createdAt": "2023-10-10T13:39:41.000Z"
            },
            {
                "hash": "322948144e20c69370a3f0707505346fe275f1b5",
                "payload": "{\"data\": \"Texto de prueba\"}",
                "blockchainTX": "3b20eb33f50ecc7143cb4769741a8e09eea7e47025ba67bf025cac0dc13fa441",
                "confirmations": 1856,
                "createdAt": "2023-10-10T13:39:40.000Z"
            },
            {
                "hash": "322948144e20c69370a3f0707505346fe275f1b5",
                "payload": "{\"data\": \"Texto de prueba\"}",
                "blockchainTX": "baf3577dc3ead3a0492a39883191183fab4ec48ea27f3a0c7e8cb850435cfc1c",
                "confirmations": 1856,
                "createdAt": "2023-10-10T13:39:38.000Z"
            },
            {
                "hash": "322948144e20c69370a3f0707505346fe275f1b5",
                "payload": "{\"data\": \"Texto de prueba\"}",
                "blockchainTX": "ead7d8a0aa2cd0b88e05a5a9638114ef0ece01b693ee5a93cdefe5a94534b77d",
                "confirmations": 1856,
                "createdAt": "2023-10-10T13:39:38.000Z"
            },
            {
                "hash": "322948144e20c69370a3f0707505346fe275f1b5",
                "payload": "{\"data\": \"Texto de prueba\"}",
                "blockchainTX": "6ad65b75db8e7d4c517e6420d6a569b83f18949f92138b9b5ba3269e8fc90503",
                "confirmations": 1857,
                "createdAt": "2023-10-10T13:37:11.000Z"
            },
            {
                "hash": "322948144e20c69370a3f0707505346fe275f1b5",
                "payload": "{\"data\": \"Texto de prueba\"}",
                "blockchainTX": "7aac2f5cc6efc88a65c788ce6ffc4fa128e056492b7dbe959523d7483e4651ae",
                "confirmations": 2157,
                "createdAt": "2023-10-09T15:36:51.000Z"
            }
        ]
    },
    "payload": {},
    "timestamp": "2023-10-24T14:27:18.781Z"
}

donde:

• hash: Es la firma hash (sha-1) localizada en la transacción de Blockchain sobre el payload enviado.
• payload: Información enviada en la transacción.
• blockchainTX: Código de la transacción en la red de Blockchain.
• confirmations: Número de confirmaciones de la transacción en la red de Blockchain.
• createdAt: Fecha y hora de creación de la transacción.

info

Las transacciones vienen ordenadas según se han ido generando por lo que el listado muestra el orden de la trazabilidad de los datos.

tip

Se entenderá que una transacción ha sido confirmada y por tanto fiable a partir de 3 confirmaciones en la red de Blockchain.