Vai al contenuto

Novita'

Ottobre 2026: nuova piattaforma

L'API e' stata portata su una nuova infrastruttura. Per chi integra non cambia nulla di obbligatorio: stessa chiave, stessi percorsi, stesse risposte, stesso indirizzo IP dei webhook (108.128.140.40).

  • Nuovo host https://api.cooabit.com/api/prod/v1. Il vecchio https://dashboard.cooabit.com/api/prod/v1 continua a funzionare: potete passare al nuovo con calma.
  • La chiave e' accettata sia nell'header Api-Key sia in X-API-Key.
  • Webhook firmati: ogni notifica porta l'header X-Cooabit-Signature: t=<timestamp>,v1=<hmac>, dove v1 e' HMAC-SHA256(secret, "<timestamp>." + corpo) in esadecimale, calcolato sul corpo cosi' come ricevuto. Il secret lo trovate in dashboard, Impostazioni, oppure nella risposta alla prima configurazione via API.
  • Errori strutturati in application/problem+json, con un codice stabile nel campo type (Errori); message e message_status restano come prima.
  • Upload idempotenti con l'header Idempotency-Key; GET /webhooks/deliveries/ per vedere le ultime consegne.
  • Conservazione: 30 minuti dopo la fine dell'elaborazione non resta nessun file e nessun dato estratto. Salvate l'esito del webhook appena arriva.