API NextLink

Documentation des endpoints REST disponibles sur nextlink.space/api

v1.0

Base URL

https://nextlink.space

Authentification

Cookie de session Supabase (JWT)

Format

JSON · Content-Type: application/json

🔬

Diagnostic

2 endpoints

POST

/api/diagnostic/submit

Soumettre un diagnostic complet avec réponses

Auth

Body

company_id: string

responses: Record<string, number>[]

Réponse

diagnostic_id: string

status: completed

POST

/api/diagnostic/score

Calculer les scores par dimension

Public

Body

responses: Record<string, number>[]

Réponse

scores: Record<string, number>

overall_score: number

🤖

Recommandations IA

1 endpoint

POST

/api/recommendations/generate

Générer des recommandations personnalisées via Claude Sonnet 4

Auth

Body

diagnostic_id: string

Réponse

executive_summary: string

recommendations: Recommendation[]

quick_wins: string[]

💶

Subventions

3 endpoints

POST

/api/subsidies/match

Matcher les subventions selon profil entreprise (seuil 50%)

Auth

Body

company_id: string

diagnostic_id: string?

Réponse

matches: SubsidyMatch[]

total_potential: number

POST

/api/subsidies/estimate

Estimer le potentiel subvention sans diagnostic

Public

Body

sector: string

employee_count: number

zone_zfrr: boolean

Réponse

estimate_min: number

estimate_max: number

GET

/api/subsidies/export

Exporter les subventions matchées en PDF

Auth

Réponse

pdf: Blob (application/pdf)

🚀

Projets

3 endpoints

GET

/api/projects

Lister les projets de l'entreprise

Auth

Réponse

projects: Project[]

POST

/api/projects

Créer un nouveau projet

Auth

Body

diagnostic_id: string?

nextlink_tier: audit|smart_factory|support

budget_total: number?

Réponse

id: string

status: planifie

PUT

/api/projects/[id]

Mettre à jour un projet

Auth

Body

status: ProjectStatus?

milestones: Milestone[]?

kpis: KPI[]?

Réponse

ok: true

🏭

Entreprise

3 endpoints

POST

/api/companies/enrich

Enrichir les données via SIREN (Pappers/INSEE)

Auth

Body

siren: string

Réponse

naf_code: string

employee_range: string

city: string

PATCH

/api/companies/update-zfrr

Mettre à jour le statut zone ZFRR

Auth

Body

zone_zfrr: boolean

city: string?

Réponse

ok: true

POST

/api/companies/onboarding

Persister l'étape d'onboarding

Auth

Body

step: number?

completed: boolean?

Réponse

ok: true

🔔

Notifications

1 endpoint

GET

/api/notifications

Lister les notifications de l'utilisateur

Auth

Réponse

notifications: Notification[]

unread_count: number

⭐

NPS & Feedback

2 endpoints

POST

/api/nps

Soumettre une réponse NPS (0-10)

Public

Body

score: number (0-10)

comment: string?

diagnostic_id: string?

Réponse

success: true

GET

/api/nps

Statistiques NPS agrégées (admin seulement)

Auth

Réponse

nps: number

total: number

promoters: number

detractors: number

💳

Paiement

2 endpoints

POST

/api/stripe/checkout

Créer une session Stripe Checkout

Auth

Body

product_key: audit|smart_factory_25k|smart_factory_45k|support_monthly|support_premium

project_id: string?

Réponse

url: string (redirect URL)

POST

/api/stripe/webhook

Webhook Stripe — traitement paiements (signature vérifiée)

Public

Réponse

received: true

📡

IoT — Collecte temps réel

3 endpoints

POST

/api/collect

Envoyer une mesure depuis un capteur (auth par clé API X-API-Key)

Auth

Body

source: string (identifiant capteur)

value: number

unit: string (°C, %, mm/s, bar, kW, kWh, pcs, rpm, L/min, μg/m³)

timestamp: string (ISO 8601, optionnel — défaut: now)

metadata: object optionnel { machine, zone, ... }

Réponse

ok: true

id: string

POST

/api/iot/webhook

Webhook IoT batch — envoi de plusieurs mesures avec signature HMAC-SHA256

Public

Body

api_key: string (clé générée dans Collecteurs)

readings: Array<{ sensor_id: uuid, value: number, recorded_at?: string, metadata?: object }>

Réponse

inserted: number

errors: number

GET

/api/iot/stream

Server-Sent Events — flux temps réel des métriques et alertes (5s polling, timeout 5min)

Auth

Body

company_id: string (query param)

Réponse

event: connected: { company_id, timestamp }

event: metrics: { data: Record<metric_type, { value, unit, recorded_at }>, timestamp }

event: alerts: { data: Alert[], timestamp }

event: timeout: { message } — reconnecter dans 2 secondes

🔑

IoT — Collecteurs & Clés API

3 endpoints

GET

/api/collect/keys

Lister les clés API IoT de l'utilisateur

Auth

Réponse

keys: CollectorKey[]

POST

/api/collect/keys

Générer une nouvelle clé API IoT (format nxl_xxxx)

Auth

Body

label: string

site_id: string?

Réponse

key: string (affiché une seule fois)

id: string

DELETE

/api/collect/keys/[id]

Révoquer une clé API IoT

Auth

Réponse

ok: true

Questions ? clement.creuzenet@skema.edu

Retour

API NextLink

Documentation des endpoints REST disponibles sur nextlink.space/api

v1.0

Base URL

https://nextlink.space

Authentification

Cookie de session Supabase (JWT)

Format

JSON · Content-Type: application/json

🔬

Diagnostic

2 endpoints

POST

/api/diagnostic/submit

Soumettre un diagnostic complet avec réponses

Auth

Body

company_id: string

responses: Record<string, number>[]

Réponse

diagnostic_id: string

status: completed

POST

/api/diagnostic/score

Calculer les scores par dimension

Public

Body

responses: Record<string, number>[]

Réponse

scores: Record<string, number>

overall_score: number

🤖

Recommandations IA

1 endpoint

POST

/api/recommendations/generate

Générer des recommandations personnalisées via Claude Sonnet 4

Auth

Body

diagnostic_id: string

Réponse

executive_summary: string

recommendations: Recommendation[]

quick_wins: string[]

💶

Subventions

3 endpoints

POST

/api/subsidies/match

Matcher les subventions selon profil entreprise (seuil 50%)

Auth

Body

company_id: string

diagnostic_id: string?

Réponse

matches: SubsidyMatch[]

total_potential: number

POST

/api/subsidies/estimate

Estimer le potentiel subvention sans diagnostic

Public

Body

sector: string

employee_count: number

zone_zfrr: boolean

Réponse

estimate_min: number

estimate_max: number

GET

/api/subsidies/export

Exporter les subventions matchées en PDF

Auth

Réponse

pdf: Blob (application/pdf)

🚀

Projets

3 endpoints

GET

/api/projects

Lister les projets de l'entreprise

Auth

Réponse

projects: Project[]

POST

/api/projects

Créer un nouveau projet

Auth

Body

diagnostic_id: string?

nextlink_tier: audit|smart_factory|support

budget_total: number?

Réponse

id: string

status: planifie

PUT

/api/projects/[id]

Mettre à jour un projet

Auth

Body

status: ProjectStatus?

milestones: Milestone[]?

kpis: KPI[]?

Réponse

ok: true

🏭

Entreprise

3 endpoints

POST

/api/companies/enrich

Enrichir les données via SIREN (Pappers/INSEE)

Auth

Body

siren: string

Réponse

naf_code: string

employee_range: string

city: string

PATCH

/api/companies/update-zfrr

Mettre à jour le statut zone ZFRR

Auth

Body

zone_zfrr: boolean

city: string?

Réponse

ok: true

POST

/api/companies/onboarding

Persister l'étape d'onboarding

Auth

Body

step: number?

completed: boolean?

Réponse

ok: true

🔔

Notifications

1 endpoint

GET

/api/notifications

Lister les notifications de l'utilisateur

Auth

Réponse

notifications: Notification[]

unread_count: number

⭐

NPS & Feedback

2 endpoints

POST

/api/nps

Soumettre une réponse NPS (0-10)

Public

Body

score: number (0-10)

comment: string?

diagnostic_id: string?

Réponse

success: true

GET

/api/nps

Statistiques NPS agrégées (admin seulement)

Auth

Réponse

nps: number

total: number

promoters: number

detractors: number

💳

Paiement

2 endpoints

POST

/api/stripe/checkout

Créer une session Stripe Checkout

Auth

Body

product_key: audit|smart_factory_25k|smart_factory_45k|support_monthly|support_premium

project_id: string?

Réponse

url: string (redirect URL)

POST

/api/stripe/webhook

Webhook Stripe — traitement paiements (signature vérifiée)

Public

Réponse

received: true

📡

IoT — Collecte temps réel

3 endpoints

POST

/api/collect

Envoyer une mesure depuis un capteur (auth par clé API X-API-Key)

Auth

Body

source: string (identifiant capteur)

value: number

unit: string (°C, %, mm/s, bar, kW, kWh, pcs, rpm, L/min, μg/m³)

timestamp: string (ISO 8601, optionnel — défaut: now)

metadata: object optionnel { machine, zone, ... }

Réponse

ok: true

id: string

POST

/api/iot/webhook

Webhook IoT batch — envoi de plusieurs mesures avec signature HMAC-SHA256

Public

Body

api_key: string (clé générée dans Collecteurs)

readings: Array<{ sensor_id: uuid, value: number, recorded_at?: string, metadata?: object }>

Réponse

inserted: number

errors: number

GET

/api/iot/stream

Server-Sent Events — flux temps réel des métriques et alertes (5s polling, timeout 5min)

Auth

Body

company_id: string (query param)

Réponse

event: connected: { company_id, timestamp }

event: metrics: { data: Record<metric_type, { value, unit, recorded_at }>, timestamp }

event: alerts: { data: Alert[], timestamp }

event: timeout: { message } — reconnecter dans 2 secondes

🔑

IoT — Collecteurs & Clés API

3 endpoints

GET

/api/collect/keys

Lister les clés API IoT de l'utilisateur

Auth

Réponse

keys: CollectorKey[]

POST

/api/collect/keys

Générer une nouvelle clé API IoT (format nxl_xxxx)

Auth

Body

label: string

site_id: string?

Réponse

key: string (affiché une seule fois)

id: string

DELETE

/api/collect/keys/[id]

Révoquer une clé API IoT

Auth

Réponse

ok: true

Questions ? clement.creuzenet@skema.edu