Documentation API

Authentification

Toutes les requêtes doivent inclure votre clé API dans l'en-tête Authorization. Générez vos clés depuis Dashboard → Clés API.

Authorization: Bearer sk_strat_xxxxxxxxxxxxxxxx

Exemple curl complet :

curl https://stratigraphy.pro/api/v1/calls \
  -H "Authorization: Bearer sk_strat_xxxxxxxxxxxxxxxx"

Rate limits

Les limites s'appliquent par clé API. Les en-têtes de réponse indiquent l'état courant.

Au-delà des limites, l'API retourne 429 Too Many Requests avec X-RateLimit-Remaining: 0.

Scopes

Chaque clé API porte un sous-ensemble de scopes. Vous choisissez les scopes à la création de clé.

GET/api/v1/calls

Liste les appels à projets avec filtres. Retourne jusqu'à 100 AAP par requête. Scope requis : calls:read.

Paramètres query

Exemple

curl "https://stratigraphy.pro/api/v1/calls?status=open&limit=5" \
  -H "Authorization: Bearer sk_strat_xxx"

# Réponse 200
{
  "data": [
    {
      "id": 1042,
      "title": "AAP Innovation PME 2025",
      "organization": "BPI France",
      "status": "open",
      "deadline_at": "2025-09-30T23:59:00Z",
      "funding_type": "subvention",
      "budget_min_eur": 50000,
      "budget_max_eur": 500000,
      "geography": "France",
      "trl_min": 3,
      "trl_max": 7,
      "official_url": "https://..."
    }
  ],
  "total": 1
}

GET/api/v1/projects

Retourne tous les projets de l'organisation liée à la clé API. Scope requis : projects:read.

curl https://stratigraphy.pro/api/v1/projects \
  -H "Authorization: Bearer sk_strat_xxx"

# Réponse 200
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Projet NOVA",
      "domain": "énergie",
      "keywords": ["hydrogène", "électrolyse"],
      "current_trl": 4,
      "target_trl": 7,
      "organization_id": "..."
    }
  ]
}

POST/api/v1/projects

Crée un nouveau projet R&D. Scope requis : projects:write.

Corps JSON

Exemple

curl -X POST https://stratigraphy.pro/api/v1/projects \
  -H "Authorization: Bearer sk_strat_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Projet NOVA",
    "description": "Électrolyseur PEM haute pression pour production H2",
    "keywords": ["hydrogène", "PEM", "électrolyse"],
    "current_trl": 4,
    "target_trl": 7,
    "estimated_budget_k_eur": 850
  }'

# Réponse 201
{ "data": { "id": "550e8400-...", "name": "Projet NOVA", ... } }

POST/api/v1/audit

Déclenche un audit IA approfondi d'un AAP : vérification de la deadline en live (web search), analyse des critères d'éligibilité, risques et recommandations. Scope requis : audit:run. Quota : 5/mois (Solidarité), illimité (PME+).

Corps JSON

Exemple

curl -X POST https://stratigraphy.pro/api/v1/audit \
  -H "Authorization: Bearer sk_strat_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "call_id": 1042,
    "project_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

# Réponse 200
{
  "data": {
    "call_id": 1042,
    "eligibility": "haute",
    "score": 82,
    "deadline_confirmed": true,
    "deadline_at": "2025-09-30T23:59:00Z",
    "risks": ["Budget max 500k€ peut être insuffisant pour phase 4"],
    "recommendation": "Candidater avec focus sur les livrables TRL 4→6",
    "reasoning": "..."
  }
}

POST/api/v1/subscriptions/deadlines

S'abonne à des alertes webhook pour les deadlines d'AAP. Scope requis : webhooks:write. Disponible Cabinet et API/Agent.

Corps JSON

Serveur MCP

Stratigraphy expose un serveur Model Context Protocol compatible avec Claude, Cursor, Zed et tout client MCP. Disponible Cabinet et API/Agent.

Configuration claude_desktop_config.json

{
  "mcpServers": {
    "stratigraphy": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/client-http", "https://stratigraphy.pro/mcp"],
      "env": {
        "MCP_BEARER_TOKEN": "sk_strat_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Outils disponibles

Codes d'erreur

Format d'erreur type

{
  "error": "quota_exceeded",
  "message": "Audit IA : quota mensuel atteint (5/5). Passez au plan PME pour un accès illimité.",
  "upgradeUrl": "https://stratigraphy.pro/pricing"
}