Naiwenn Retraite · API v1.1

API Retraite B2B

Tu as déjà une intention ? Choisis-la. Les surfaces live restent la vérité runtime.

Surfaces live

GET /api/v1/retraite/health
GET /status/api (SLA soft)
GET /api/v1/retraite/manifest
GET /api/v1/retraite/openapi.json
Auth : Bearer nai_… ou OAuth2 client_credentials → JWT
Self-service org : /api/org/retraite-api (session OWNER/ADMIN)

Qui es-tu ?

Intégrateur SI — health → oauth/token ou clé → /me. OpenAPI pour SDK.

Mandataire — pack mandataire · POST /runs · lacunes.

Employeur — pack employeur · POST /hooks/exposure.

Organisme — pack organisme · POST /hooks/precontentieux.

Agent / A2A — fourchette indicative uniquement · jamais CERTIFIE.

Contrat SI (headers)

X-Request-Id — echo sur chaque réponse (à joindre au Support)
X-RateLimit-Limit / Remaining / Reset — quotas org mensuels
Idempotency-Key — recommandé sur POST /runs et lacunes (TTL 24h)
IP allowlist CIDR optionnelle par org
OAuth : POST /oauth/token grant_type=client_credentials

curl -sS -D- -H "Authorization: Bearer $KEY" -H "X-Request-Id: demo-1" \
  -H "Content-Type: application/json" \
  -X POST https://naiwenn.fr/api/v1/retraite/a2a/estimate \
  -d '{"birthYear":1975,"revenuAnnuelBrutApproxEur":42000}'

Ne jamais logger le Bearer complet. Ticket Support : préfixe clé seulement.

Support client

Canal principal intégrateurs : turpinji@gmail.com

Joindre : org_id, key_prefix, endpoint, status, error JSON, runId, X-Request-Id, UTC.

Environnements

prod — https://naiwenn.fr
staging / sandbox — même code, org dédiée + quotas élevés (demander une clé sandbox)
local — http://127.0.0.1:8787 · flag RETRAITE_API_V1_ENABLED=1

CERTIFIE

Grant restitution.certified + restitutionLevel ≥ 2. Jamais sur A2A libre / estimate.