Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

curl -X POST https://api.conformvault.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "motdepasse"}'

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
  "expires_in": 900,
  "token_type": "Bearer",
  "user": {
    "id": "uuid",
    "email": "user@example.com",
    "role": "client_admin",
    "mfa_enabled": false
  }
}

curl -X POST https://api.conformvault.com/api/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refresh_token": "eyJhbGciOiJIUzI1NiIs..."}'

Authorization: Bearer cvk_live_votre_cle_api

curl -X POST https://api.conformvault.com/api/v1/clients/{client_id}/files \
  -H "Authorization: Bearer {token}" \
  -F "file=@document.pdf" \
  -F "folder_id={folder_id}"

go get github.com/secuaas/conformvault-sdk-go

import cv "github.com/secuaas/conformvault-sdk-go"

client := cv.NewClient("cvk_live_votre_cle_api")

// Options
client := cv.NewClient("cvk_live_xxx",
    cv.WithBaseURL("https://api.conformvault.com/dev/v1"),
    cv.WithHTTPClient(&http.Client{Timeout: 60 * time.Second}),
)

ctx := context.Background()

// Lister les fichiers
files, err := client.Files.List(ctx, &cv.FileListOptions{
    FolderID: cv.String("folder-id"),
    Page: 1, Limit: 20,
})

// Uploader un fichier
f, _ := os.Open("document.pdf")
defer f.Close()
result, err := client.Files.Upload(ctx, f, "document.pdf", cv.String("folder-id"))

// Telecharger un fichier
reader, err := client.Files.Download(ctx, "file-id")
defer reader.Close()

// Creer un lien de partage
link, err := client.ShareLinks.Create(ctx, cv.CreateShareLinkRequest{
    FileID: cv.String("file-id"), Type: "download", ExpiresIn: 86400,
})

// Creer une enveloppe de signature
envelope, err := client.Signatures.Create(ctx, cv.CreateSignatureRequest{
    FileID: "file-id", Subject: "NDA",
    Signers: []cv.CreateSignatureSigner{
        {Email: "signataire@example.com", Name: "Jean Dupont", Role: "signer"},
    },
    ExpiryDays: 30,
})

// Generer une attestation Loi 25
pdfReader, err := client.Attestation.GenerateLoi25(ctx)

// Verifier un webhook
isValid := cv.VerifyWebhookSignature(payload, signatureHeader, "whsec_secret")

if cv.IsNotFound(err) { /* 404 */ }
if cv.IsRateLimited(err) {
    rlErr := err.(*cv.RateLimitError)
    // rlErr.RetryAfter
}
if apiErr, ok := err.(*cv.APIError); ok {
    // apiErr.StatusCode, apiErr.Message
}

pip install conformvault-sdk

from conformvault import ConformVault

client = ConformVault("cvk_live_votre_cle_api")

# Options
client = ConformVault("cvk_live_xxx",
    base_url="https://api.conformvault.com/dev/v1",
    timeout=60.0,
)

from conformvault import AsyncConformVault

async with AsyncConformVault("cvk_live_xxx") as client:
    files = await client.files.list()

# Lister les fichiers
files = client.files.list(folder_id="folder-id", page=1, limit=20)

# Uploader un fichier
with open("document.pdf", "rb") as fp:
    result = client.files.upload(fp, "document.pdf", folder_id="folder-id")

# Telecharger
content = client.files.download("file-id")

# Lien de partage
from conformvault import CreateShareLinkRequest
link = client.share_links.create(CreateShareLinkRequest(
    file_id="file-id", type="download", expires_in=86400,
))

# Signature electronique
from conformvault import CreateSignatureRequest, CreateSignatureSigner
envelope = client.signatures.create(CreateSignatureRequest(
    file_id="file-id", subject="NDA",
    signers=[CreateSignatureSigner(email="signataire@example.com", name="Jean Dupont")],
    expiry_days=30,
))

# Attestation Loi 25
pdf_bytes = client.attestation.generate_loi25()

# Verification de webhook
from conformvault import verify_webhook_signature
is_valid = verify_webhook_signature(payload, signature_header, "whsec_secret")

from conformvault import APIError, AuthenticationError, RateLimitError, is_not_found

try:
    file = client.files.get("id-inexistant")
except AuthenticationError:
    pass  # Cle API invalide (401)
except RateLimitError as e:
    print(f"Reessayer apres {e.retry_after}s")  # 429
except APIError as e:
    if is_not_found(e):
        pass  # 404
    print(f"Erreur {e.status_code}: {e.message}")

# Beta (depuis git)
npm install git+https://forge.secuaas.ovh/secuaas/conformvault-sdk-ts.git#v0.1.0

# Future (npm registry)
# npm install @conformvault/sdk

import { ConformVault } from '@conformvault/sdk';

const client = new ConformVault('cvk_live_votre_cle_api', {
  baseURL: 'https://api.conformvault.com/dev/v1', // defaut
  timeout: 30000, // 30s
  maxRetries: 3,  // retry automatique sur 429
});

// Lister les fichiers
const files = await client.files.list({ folderId: 'folder-123' });

// Uploader un fichier
const blob = new Blob(['contenu'], { type: 'text/plain' });
const uploaded = await client.files.upload(blob, 'fichier.txt');

// Telecharger
const data = await client.files.download('file-id');

// Lien de partage
const link = await client.shareLinks.create({
  file_id: 'file-id', type: 'download', expires_in: 86400,
});

// Signature electronique
const envelope = await client.signatures.create({
  file_id: 'file-abc',
  subject: 'NDA',
  signers: [{ email: 'signataire@example.com', name: 'Jean Dupont' }],
});

// Verification de webhook
import { verifyWebhookSignature } from '@conformvault/sdk';
const isValid = verifyWebhookSignature(rawBody, signatureHeader, 'whsec_secret');

import { APIError, AuthenticationError, RateLimitError, isNotFound } from '@conformvault/sdk';

try {
  await client.files.get('id-inexistant');
} catch (error) {
  if (error instanceof AuthenticationError) { /* 401 */ }
  if (error instanceof RateLimitError) { console.log(error.retryAfter); }
  if (isNotFound(error)) { /* 404 */ }
  if (error instanceof APIError) { console.log(error.statusCode, error.message); }
}

curl -X POST https://api.conformvault.com/dev/v1/webhooks \
  -H "Authorization: Bearer cvk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://votre-app.com/webhooks/conformvault",
    "events": ["file.uploaded", "signature.completed"]
  }'

{
  "id": "webhook-id",
  "url": "https://votre-app.com/webhooks/conformvault",
  "events": ["file.uploaded", "signature.completed"],
  "secret": "whsec_votre_secret"
}