Documentation

Démarrez avec l'API Anchorify

ConnectRPC

L'API Anchorify est construite avec ConnectRPC, offrant un support gRPC et HTTP/JSON. Nous recommandons d'utiliser le protocole gRPC pour de meilleures performances.

Bibliothèques Client

Autres Langages

Kotlin, Dart, Web et plus disponibles sur
connectrpc.com/docs

Démarrage rapide

L'API Anchorify vous permet de créer des preuves infalsifiables en ancrant des hashes sur des blockchains publiques. Voici comment commencer :

1. Obtenez votre clé API

Créez un compte et générez une clé API depuis la console.

2. Hashez vos données localement

Générez un hash de votre fichier ou donnée. Les données originales n'ont jamais besoin de quitter votre système.

# Avec OpenSSL (sortie hexadécimale)
openssl dgst -sha256 document.pdf

# Convertir hex en base64 pour l'API
echo -n "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" | xxd -r -p | base64

# Sortie (utilisez la chaîne base64)
47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=

3. Soumettez le hash

Envoyez le hash à notre API pour créer une notarisation. Vous recevrez un ID de notarisation pour le suivi.

cURL

NotarizeHash

curl -X POST https://api.anchorify.cloud/anchorify.notarization.v1.AnchorifyNotarizationService/NotarizeHash \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "algorithm": "HASH_ALGORITHM_SHA256",
    "hash": "IDjvWFSjiseUZTqUGy7DYVSh/NCqaM0oWS9LgTk/ayk=",
    "name": "document.pdf"
  }'

NotarizeHash

package main

import (
    "context"
    "log"
    "net/http"

    "connectrpc.com/connect"
    notarizationv1 "github.com/anchorify/platform/gen/proto/go/anchorify/notarization/v1"
    "github.com/anchorify/platform/gen/proto/go/anchorify/notarization/v1/notarizationv1connect"
)

func main() {
    client := notarizationv1connect.NewAnchorifyNotarizationServiceClient(
        http.DefaultClient,
        "https://api.anchorify.cloud",
        connect.WithGRPC(), // Recommandé : utiliser le protocole gRPC
    )

    hash := []byte{...} // Votre hash SHA-256 (32 octets)
    name := "document.pdf"

    resp, err := client.NotarizeHash(context.Background(), connect.NewRequest(&notarizationv1.NotarizeHashRequest{
        Algorithm: notarizationv1.HashAlgorithm_HASH_ALGORITHM_SHA256,
        Hash:      hash,
        Name:      &name,
    }))
    if err != nil {
        log.Fatal(err)
    }

    log.Printf("ID de notarisation : %s", resp.Msg.Notarization.Id)
}

Réponse

{
  "notarization": {
    "id": "019c0e1a-d891-7f1f-ab6e-5588c46c2a4b",
    "algorithm": "HASH_ALGORITHM_SHA256",
    "hash": "IDjvWFSjiseUZTqUGy7DYVSh/NCqaM0oWS9LgTk/ayk=",
    "status": "NOTARIZATION_STATUS_PENDING",
    "createdAt": "2026-01-30T08:52:46.353991Z",
    "name": "document.pdf"
  }
}

4. Interrogez le statut

Vérifiez le statut de la preuve. Une fois ancrée sur la blockchain, vous pouvez exporter votre document de preuve signé.

cURL

GetNotarization

curl -X POST https://api.anchorify.cloud/anchorify.notarization.v1.AnchorifyNotarizationService/GetNotarization \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "notarization_id": "019c0e1a-d891-7f1f-ab6e-5588c46c2a4b"
  }'

GetNotarization

resp, err := client.GetNotarization(context.Background(), connect.NewRequest(&notarizationv1.GetNotarizationRequest{
    NotarizationId: "019c0e1a-d891-7f1f-ab6e-5588c46c2a4b",
}))
if err != nil {
    log.Fatal(err)
}

log.Printf("Statut : %s", resp.Msg.Notarization.Status)

Réponse (complétée)

{
  "notarization": {
    "id": "019c0e1a-d891-7f1f-ab6e-5588c46c2a4b",
    "algorithm": "HASH_ALGORITHM_SHA256",
    "hash": "IDjvWFSjiseUZTqUGy7DYVSh/NCqaM0oWS9LgTk/ayk=",
    "status": "NOTARIZATION_STATUS_COMPLETED",
    "timestampProof": { ... },
    "blockchainProof": { ... },
    "createdAt": "2026-01-30T08:52:46.353991Z",
    "updatedAt": "2026-01-30T08:53:32.449111Z",
    "notarizedAt": "2026-01-30T08:53:32.449111Z",
    "name": "document.pdf"
  }
}

Référence API

POST /anchorify.notarization.v1.AnchorifyNotarizationService/NotarizeHash

Créer une preuve

Paramètres : algorithm (requis), hash (requis, base64), name (optionnel)

POST /anchorify.notarization.v1.AnchorifyNotarizationService/GetNotarization

Obtenir le statut d'une notarisation

Paramètres : notarization_id (requis)

POST /anchorify.notarization.v1.AnchorifyNotarizationService/ListNotarizations

Lister les notarisations

Paramètres : page_size (optionnel, max 100), page_token (optionnel)

POST /anchorify.notarization.v1.AnchorifyNotarizationService/Events Pro

Flux d'événements en temps réel

Paramètres : last_event_id (optionnel), event_types (optionnel), polling_interval_ms (optionnel, 100-30000)

Algorithmes de hachage supportés

Algorithmes supportés : SHA-256 (tous les plans), SHA-384 et SHA-512 (Pro et Enterprise). Le hash doit être fourni sous forme de chaîne encodée en base64.

API asynchrone

L'API est asynchrone. Soumettez votre hash et interrogez le statut, ou utilisez les webhooks (Pro+) pour les notifications.

Webhooks

Les plans Pro et Enterprise peuvent configurer des webhooks pour recevoir des notifications lorsque les preuves sont finalisées. Pro

Documents de preuve signés

Les plans Pro et Enterprise peuvent exporter des documents de preuve signés contenant toutes les preuves cryptographiques. Pro

Horodatages qualifiés

Les plans Enterprise peuvent ajouter des horodatages qualifiés eIDAS pour une valeur juridique renforcée. Enterprise