POST /api/v1/chargeflow (Premium)

Enregistrer une CFU-E

Premium. Entrée : JSON session (CPO / flotte / export type OCPI). Sortie : `cfu_e_*`, `content_hash`, `signature`, `verify_url`, enrichment Watt.

HMAC prefix : `auros-cfu-e:v1:` — même clé que les attestations (ATTEST_SIGNING_KEY).

Unicité serveur : 409 si une unité `active` existe déjà pour (clé, operator, external_session_id).

Standard public : docs/CHARGEFLOW-STANDARD.md · UI : /green/chargeflow · console : /green/chargeflow/console.

Watts Reserve (booking → CFU → secondaire) : endpoint-watts-reserve · docs/WATTS-RESERVE.md.

Liste : GET /api/v1/chargeflow · batch : POST /api/v1/chargeflow/batch (max 50).

Export audit banque : GET /api/v1/chargeflow/export?format=json|csv (Premium) — voir section Export.

curl -X POST https://getauros.com/api/v1/chargeflow \
  -H "Authorization: Bearer auros_pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "session": {
      "external_session_id": "sess_001",
      "started_at": "2026-07-19T10:00:00Z",
      "ended_at": "2026-07-19T10:42:00Z",
      "energy_kwh": 48.2,
      "location": { "country": "FR" },
      "operator_id": "cpo_demo",
      "source_format": "json_custom"
    },
    "attributes": { "renewable_claim": "go", "generation_source": "solar" }
  }'

Vérifier & retirer

GET /api/v1/chargeflow — liste Premium (filtres kind, status, operator_id).

POST /api/v1/chargeflow/batch — jusqu'à 50 CFU-E, succès partiel.

POST /api/v1/chargeflow/from-ocpi — import OCPI/CSV stub.

GET /api/v1/chargeflow/partners · POST …/partners/sync — connecteurs Tesla/Total/OCPI.

GET /api/v1/chargeflow/verify?id=cfu_e_…

POST /api/v1/chargeflow/{id}/retire — Premium, même clé API (status=retired, hash inchangé).

Webhooks : `chargeflow.unit.minted` / `chargeflow.unit.retired` (POST /api/v1/webhooks).

Page UI : /chargeflow/{id} · Demo : POST /api/v1/chargeflow/demo · Console : /green/chargeflow/console (import + export)

curl "https://getauros.com/api/v1/chargeflow?kind=e&status=active&operator_id=cpo_demo" \
  -H "Authorization: Bearer auros_pk_live_xxx"
curl "https://getauros.com/api/v1/chargeflow/verify?id=cfu_e_…"
curl -X POST https://getauros.com/api/v1/chargeflow/cfu_e_…/retire \
  -H "Authorization: Bearer auros_pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"reason":"cited in ESG claim"}'

Export portfolio (institutions)

GET /api/v1/chargeflow/export?format=json|csv — Premium, max 5000 unités de la clé (filtres kind/status/operator_id).

SDK : `client.chargeflowExport({ kind: "e", status: "active" })`.

Surface banques : /developers/institutions. Indicatif — pas une opinion d'audit réglementée.

curl "https://getauros.com/api/v1/chargeflow/export?format=json&status=active" \
  -H "Authorization: Bearer auros_pk_live_xxx"
curl "https://getauros.com/api/v1/chargeflow/export?format=csv" \
  -H "Authorization: Bearer auros_pk_live_xxx" -o cfu-portfolio.csv

Disclaimer

Enregistrement off-chain indicatif — pas un token on-chain, pas un certificat d'origine.

attributes.generation_source (solar|wind|hydro|nuclear|…) = claim technologique indicatif, pas GO/REC ni Green Verified.

CFU-W (eau) : POST /api/v1/chargeflow/w — voir endpoint-chargeflow-w.