AUROS Protocol

Documentation · Endpoints

POST /api/v1/chargeflow (Premium)

AUROS ChargeFlow CFU-E — enregistre une session de charge kWh en unité de flux hashée + HMAC, avec Watt companion.

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.

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

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" }
  }'

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"}'

Disclaimer

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

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

Pages associées

← Retour à la documentation