Endpoints Lisibles par Machine

fiskaly publie un ensemble d’endpoints lisibles par machine aux côtés du site de documentation lisible par l’humain. Ces endpoints sont conçus pour les agents IA, les crawlers LLM et les pipelines d’automatisation qui nécessitent un accès structuré aux métadonnées produit, aux spécifications API et aux données réglementaires.

Référence des endpoints

Endpoint	Format	Objectif
/llms.txt	Texte brut	Index de découverte LLM — liste toutes les pages de documentation et les URLs de spécifications
/llms-full.txt	Texte brut	Dump complet de la documentation pour l’ingestion de contexte LLM
/products.json	JSON	Manifeste produit avec métadonnées, URLs de base et URLs de spécifications pour les 14 produits
/human-interventions.json	JSON	Registre des actions automatisables vs. nécessitant un humain avec comptages résumés
/regulatory.json	JSON	Exigences réglementaires et détails de conformité par pays
/.well-known/ai-plugin.json	JSON	Manifeste plugin IA (format de spécification plugin OpenAI)
/CLAUDE.md	Markdown	Guide d’intégration pour agents avec authentification, patterns et référence par pays
/specs/sign-de-v2.json	JSON	Spécification OpenAPI SIGN DE v2
/specs/spec-sign-at.json	JSON	Spécification OpenAPI SIGN AT (RKSV)
/specs/fiskaly.sign-fr.2026-02-03.yaml	YAML	Spécification OpenAPI SIGN FR (API Unifiée)
/specs/fiskaly.sign-it.2026-02-03.yaml	YAML	Spécification OpenAPI SIGN IT (API Unifiée)
/specs/fiskaly.e-invoice-be.2026-02-03.yaml	YAML	Spécification OpenAPI E-INVOICE BE (API Unifiée)
/specs/fiskaly.e-invoice-de.2026-02-03.yaml	YAML	Spécification OpenAPI E-INVOICE DE (API Unifiée)
/specs/spec-sign-es.yaml	YAML	Spécification OpenAPI SIGN ES
/specs/spec-dsfinvk.json	JSON	Spécification OpenAPI DSFinV-K
/specs/spec-ereceipt.json	JSON	Spécification OpenAPI eReceipt
/specs/spec-merchant.json	JSON	Spécification OpenAPI Management API
/specs/spec-obono.json	JSON	Spécification OpenAPI obono (SIGN AT SaaS)

Tous les endpoints sont servis depuis https://workspace.fiskaly.com.

Flux de découverte

Un flux de découverte typique d’un agent ressemble à ceci :

1. Récupérer /llms.txt
   → Obtenir un index de toute la documentation et des spécifications disponibles

2. Récupérer /products.json
   → Trouver le produit correspondant au pays cible
   → Extraire baseUrls, specUrl et docsUrl

3. Récupérer /specs/{product-spec}
   → Charger la spécification OpenAPI complète pour le produit choisi

4. Récupérer /human-interventions.json
   → Identifier quelles étapes sont automatisables vs. nécessitant un humain

products.json

Le manifeste produit est l’endpoint de données structurées principal. Chaque entrée produit inclut :

{
  "id": "sign-de",
  "name": "SIGN DE",
  "description": "German fiscal signing (KassenSichV)",
  "country": "DE",
  "apiArchitecture": "specialized",
  "baseUrls": {
    "test": "https://kassensichv-middleware.fiskaly.com/api/v2",
    "live": "https://kassensichv.fiskaly.com/api/v2"
  },
  "specUrl": "/specs/sign-de-v2.json",
  "docsUrl": "/countries/germany",
  "apiReferenceUrl": "/api/sign-de"
}

Utilisez apiArchitecture pour déterminer le pattern d’intégration :

• specialized — URL de base par pays, UUIDs générés par le client, Management API séparée
• unified — URLs de base partagées, IDs générés par le serveur, headers obligatoires (X-Api-Version, X-Idempotency-Key, X-Scope-Identifier)
• platform — services transversaux aux produits (DSFinV-K, eReceipt, Management API)

human-interventions.json

Retourne toutes les actions d’intégration catégorisées par niveau d’automatisation :

{
  "summary": {
    "fullyAutomatable": 11,
    "partiallyAutomatable": 2,
    "requiresHuman": 7
  },
  "interventions": [
    {
      "action": "Authenticate (get token)",
      "product": "All",
      "automatable": "yes",
      "reason": "Standard API call",
      "whatToDo": "POST /auth with api_key + api_secret"
    }
  ]
}

Voir le Registre des Interventions Humaines pour la référence complète lisible par l’humain.

ai-plugin.json

Le manifeste plugin IA suit le format de spécification du plugin OpenAI :

{
  "schema_version": "v1",
  "name_for_model": "fiskaly",
  "description_for_model": "fiskaly provides fiscal compliance APIs...",
  "api": {
    "type": "openapi",
    "url": "https://workspace.fiskaly.com/specs/sign-de-v2.json"
  }
}

Accès des crawlers

La configuration robots.txt autorise les crawlers LLM à accéder à tous les endpoints de documentation et lisibles par machine. Les crawlers web standard sont autorisés pour les pages de documentation, les fichiers de spécifications et les endpoints de données structurées.

💡Tip

Préférez le serveur MCP à la récupération HTTP brute lorsque vous travaillez dans Claude Code ou Cursor. Le serveur MCP fournit les mêmes données via des appels d’outils structurés avec recherche et filtrage intégrés. Voir le guide du serveur MCP.