Documentation API SealTrust

Récupérez une liste paginée de vos produits.

Créez un nouveau produit. Déclenchez optionnellement le minting NFT automatique.

Récupérez un produit par son ID, incluant le tag NFC et le statut NFT.

Mettez à jour les détails du produit. Seuls les champs fournis seront modifiés.

Déclenchez le minting NFT pour un produit. Le processus est asynchrone — utilisez les webhooks ou le polling pour suivre le statut.

Émettez un nouveau certificat pour un produit.

Révoquez un certificat précédemment émis. Cette action est irréversible et enregistrée on-chain.

Vérifiez la validité d'un certificat, y compris la vérification on-chain.

Vérification SDM

Vérifiez un produit à l'aide des données cryptographiques d'un tag NFC NTAG 424 DNA. L'UID, le compteur et le CMAC sont extraits de l'URL NDEF du tag.

Vérification par tap NFC

Les utilisateurs finaux peuvent vérifier les produits en approchant simplement le tag NFC avec leur smartphone. Aucune application requise.

Enregistrez un endpoint webhook pour recevoir les événements.

Types d'événements

Vérification de signature HMAC

Chaque requête webhook inclut un en-tête X-SealTrust-Signature. Vérifiez-le avec HMAC-SHA256 et votre secret webhook pour vous assurer de l'authenticité de la requête.

import crypto from 'crypto';

function verifyWebhook(
  payload: string,
  signature: string,
  secret: string,
): boolean {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected),
  );
}

// In your webhook handler:
app.post('/webhooks/sealtrust', (req, res) => {
  const signature = req.headers['x-sealtrust-signature'];
  const isValid = verifyWebhook(
    JSON.stringify(req.body),
    signature,
    process.env.SEALTRUST_WEBHOOK_SECRET,
  );

  if (!isValid) {
    return res.status(401).send('Invalid signature');
  }

  const { type, data } = req.body;
  switch (type) {
    case 'product.minted':
      handleProductMinted(data);
      break;
    case 'product.scanned':
      handleProductScanned(data);
      break;
  }

  res.status(200).send('OK');
});

Créez ou mettez à jour le Passeport Numérique d'un produit.

Récupérez le Passeport Numérique d'un produit, incluant l'URL publique et le QR code.

Installation

npm install @sealtrust/sdk
# or
yarn add @sealtrust/sdk
# or
pnpm add @sealtrust/sdk

Initialisation

import { SealTrust } from '@sealtrust/sdk';

// Initialize with your API key
const st = new SealTrust('st_live_your_api_key', {
  // Optional configuration
  baseUrl: 'https://api.sealtrust.io/v1',  // default
  timeout: 30000,                            // 30s default
  retries: 3,                                // auto-retry on 5xx
});

Exemples d'utilisation

// Create a product and mint its NFT
const product = await st.products.create({
  name: 'Artisan Watch',
  sku: 'WATCH-001',
  autoMint: true,
});

// Wait for minting to complete
const minted = await st.products.waitForMint(product.id, {
  pollInterval: 2000,  // check every 2s
  timeout: 120000,     // max 2 min
});

console.log('NFT token ID:', minted.nft.tokenId);
console.log('View on chain:', minted.nft.explorerUrl);

En cas d'erreur, l'API retourne un objet JSON avec une clé error contenant le code, le message, le statut HTTP et un identifiant de requête unique pour le débogage.

{
  "error": {
    "code": "product_not_found",
    "message": "No product found with ID 'prod_invalid'",
    "status": 404,
    "request_id": "req_abc123xyz"
  }
}