SmartCheck es una funcionalidad de Code Contract que te permite generar evidencias digitales únicas, seguras e inalterables en cuestión de segundos y a un costo accesible.

Entre sus aplicaciones, una de las más habituales es la certificación de contenido de Excel. A continuación detallamos como podrás realizar estos registros:

Paso 1: Obtener el token de autenticación

Para utilizar la API de SmartCheck, primero debes autenticarte mediante una solicitud POST para obtener un Token JWT.

Petición de autenticación (HTTP Request)

http
POST /login HTTP/1.1
Host: api.codecontract.io
Content-Type: application/json

{
    "email": "[email protected]",
    "password": "tu_contraseña"
}

Respuesta esperada

http
HTTP/1.1 200 OK
Content-Type: application/json

{
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Importante:

✔️ El token devuelto debe almacenarse y enviarse en cada petición posterior como Bearer Token en la cabecera de autorización.

✔️ Si Microsoft Excel usa OAuth para autenticarse, primero debes obtener un token OAuth y enviarlo a SmartCheck.

Paso 2: Leer datos de Excel y certificarlos con SmartCheck

Puedes usar Microsoft Graph API o Python con Pandas para extraer los datos de una hoja de cálculo y enviarlos a SmartCheck.

Ejemplo: Obtener datos de Excel y certificarlos en Blockchain

A continuación, se muestra cómo leer los datos de un archivo de Excel y enviarlos a SmartCheck.

1️⃣ Obtener los datos de un archivo Excel con Python

python
import pandas as pd

def get_excel_data(file_path, sheet_name):
    """ Lee datos de un archivo Excel """
    df = pd.read_excel(file_path, sheet_name=sheet_name)
    return df.values.tolist()

# Reemplaza con tu archivo de Excel y hoja específica
EXCEL_FILE = "datos.xlsx"
SHEET_NAME = "Hoja1"

excel_data = get_excel_data(EXCEL_FILE, SHEET_NAME)
print("Datos obtenidos de Excel:", excel_data)

2️⃣ Enviar los datos de Excel a SmartCheck

python
import requests

def certify_excel_data(data):
    """ Envía los datos de Excel a SmartCheck para certificación """
    url = "https://api.codecontract.io/smartcheck/createTreeAndRegisterMerkleRoot"
    headers = {
        "Authorization": "Bearer TU_TOKEN",
        "Content-Type": "application/json"
    }
    payload = {
        "data": data
    }

    response = requests.post(url, json=payload, headers=headers)
    return response.json()

# Certificar los datos obtenidos de Excel
certification_response = certify_excel_data(excel_data)

print("Certificación realizada:", certification_response)

Respuesta esperada

json
{
    "merkleRoot": "abc123...",
    "transactionId": "tx123...",
    "status": "success"
}

¿Qué significa esto?
✔️ merkleRoot: Raíz de Merkle generada a partir de los datos.
✔️ transactionId: ID de la transacción en la blockchain.
✔️ status: Indica si la certificación fue exitosa.

Paso 3: Verificar datos certificados en Excel

Si necesitas verificar que los datos han sido certificados, puedes consultar la prueba en SmartCheck.

Petición para btener detalles de la certificación

http
GET /smartcheck/reportsProofDetail?reportId=tu_report_id HTTP/1.1
Host: api.codecontract.io
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

Respuesta esperada

json
{
    "reportId": "tu_report_id",
    "merkleRoot": "abc123...",
    "data": [
        ["ID", "Nombre", "Monto", "Fecha"],
        ["1", "Juan Pérez", "500", "2024-02-10"],
        ["2", "María López", "750", "2024-02-11"]
    ],
    "status": "verified"
}

Resumen

✔️ Paso 1: Obtén el Token JWT mediante autenticación con tu cuenta de Microsoft.
✔️ Paso 2: Usa Python con Pandas o Microsoft Graph API para recuperar los datos almacenados en Excel.
✔️ Paso 3: Envía los datos a SmartCheck para certificarlos en blockchain.
✔️ Paso 4: Verifica la certificación cuando sea necesario.

Si necesitas más información o soporte, contacta con el equipo de Code Contract. 🚀