Plans et limites

Chaque espace de travail Coffrify est rattaché à un plan qui détermine ses limites : volume de stockage, bande passante mensuelle, nombre de transferts actifs et taille maximale par transfert. Cette page décrit ces limites et la façon dont l'API les expose, afin que vous puissiez les lire programmatiquement et anticiper les dépassements. Les prix associés à chaque plan figurent sur la page de tarifs du site coffrify.com ; cette page reste volontairement factuelle et ne traite que des limites techniques.

Les plans

Coffrify propose quatre plans. Côté API, le nom du plan est toujours renvoyé en minuscules : free, pro, ultra et entreprise. Le plan entreprise est sur devis et ses limites sont configurées au cas par cas, donc les valeurs ci-dessous indiquées comme illimitées pour ce plan correspondent à des plafonds définis dans votre contrat plutôt qu'à des bornes fixes.

Lire le plan courant

L'endpoint GET /v1/billing/subscription renvoie le plan actif de l'espace de travail et l'état de l'abonnement. Il requiert le scope billing:read.

import { Coffrify } from '@coffrify/sdk';
 
const coffrify = new Coffrify({ apiKey: process.env.COFFRIFY_API_KEY });
 
const sub = await coffrify.billing.subscription.retrieve();
console.log(sub.workspace.plan); // 'free' | 'pro' | 'ultra' | 'entreprise'

Vérifier les quotas et la consommation

L'endpoint GET /v1/quotas/check est le point d'entrée principal pour connaître l'état des limites. Il renvoie les plafonds du plan courant (caps), la consommation actuelle (consumption) et des indicateurs de dépassement (over_quota). Il requiert le scope quotas:read. Une valeur null dans caps signifie illimité pour le plan concerné, et les pourcentages associés valent alors 0.

{
  "plan": "pro",
  "caps": {
    "storage_bytes": 1099511627776,
    "bandwidth_bytes_per_month": 536870912000,
    "active_transfers": 25,
    "max_transfer_size_bytes": 107374182400
  },
  "consumption": {
    "storage_bytes": 412316860416,
    "storage_pct": 37,
    "bandwidth_bytes_last_30d": 161061273600,
    "bandwidth_pct": 30,
    "active_transfers": 8,
    "active_transfers_pct": 32
  },
  "over_quota": {
    "storage": false,
    "bandwidth": false,
    "active_transfers": false
  }
}

Pensez à appeler GET /v1/quotas/check avant de créer un gros transfert : si over_quota.active_transfers ou over_quota.storage vaut true, la création échouera côté API. Vous pouvez ainsi présenter un message clair à vos utilisateurs plutôt que de laisser l'appel échouer.

Comment les limites s'appliquent côté API

• Taille par transfert : un transfert dont la somme des fichiers dépasse max_transfer_size_bytes est refusé à la création (validation_error).
• Transferts actifs : lorsque le nombre de transferts en cours atteint active_transfers, toute nouvelle création est bloquée jusqu'à ce qu'un transfert expire ou soit supprimé. Sur ultra et entreprise, ce plafond est illimité (null).
• Stockage : lorsque le stockage utilisé atteint storage_bytes, les nouveaux envois sont bloqués. Libérez de l'espace en supprimant des transferts ou passez à un plan supérieur.
• Bande passante : la consommation est mesurée sur une fenêtre glissante de 30 jours. À l'approche du plafond, des évènements d'avertissement sont émis (voir plus bas).

Suivre l'usage dans le temps

Plusieurs endpoints renvoient des séries temporelles pour suivre la consommation et la rapprocher des limites. Ils utilisent tous le scope quotas:read et renvoient une liste paginée (object: "list"). Selon le plan, certaines séries fines comme le débit instantané peuvent ne pas être disponibles.

$ curl "https://api.coffrify.com/v1/quotas/bandwidth?days=30" \
    -H "Authorization: Bearer $COFFRIFY_API_KEY"

Réagir aux seuils via les webhooks

Plutôt que d'interroger les quotas en boucle, abonnez-vous aux évènements de facturation pour être prévenu automatiquement. Ils permettent d'alerter une équipe ou de déclencher une montée en plan avant un blocage.

• workspace.usage_limit_warning : la consommation approche d'un plafond.
• workspace.usage_limit_reached : un plafond est atteint, les envois concernés sont bloqués.
• workspace.plan_changed : le plan de l'espace de travail a changé (les nouvelles limites s'appliquent).
• billing.trial_started, billing.trial_ending, billing.subscription_cancelled : cycle de vie de l'abonnement.