El recuento de solicitudes no es lo mismo que el coste del proveedor
Listar las conexiones almacenadas es una lectura de pequeña base de datos, mientras que al conectar o sincronizar un intercambio se realizan llamadas a proveedores firmados, normalización y actualizaciones de instantáneas. Una cuota fija de solicitudes oculta esa diferencia. Los créditos ponderados hacen visible el coste relativo y permiten que una integración elija endpoints de metadatos más baratos cuando no necesita trabajo nuevo del proveedor.
Los pesos base se combinan con multiplicadores acotados
El catálogo publica un coste base y un coste máximo. Las lecturas basadas en páginas se multiplican entre 51 y 100 elementos, mientras que los extremos de historia escalan desde ventanas cortas de 24 horas y 7 días hasta un máximo de toda la historia. Las operaciones de conexión y sincronización permanecen fijas. GET /api/v1/usage/credits devuelve las reglas en vivo para presupuestación y advertencias del lado del cliente.
Observa el coste y el saldo restante en cada respuesta
Las respuestas contabilizadas correctas incluyen X-Credit-Cost y X-Credits-Remaining. Registra ambos valores en las métricas del servidor y avisa a los operadores antes de que el saldo llegue a cero. La respuesta HTTP 402 con el código insufficient_credits incluye el coste de la operación y el saldo restante, para que el producto pueda pausar actualizaciones no esenciales y dirigir al responsable de facturación a un paquete de créditos.
Asigna créditos a las tareas del producto
Separa las acciones interactivas del usuario de las actualizaciones y rellenos programados. Reserva suficiente saldo para las acciones de conexión y sincronización manual, limita la concurrencia en segundo plano y evita refrescar a los usuarios que no han regresado. Un presupuesto diario simple por entorno evita que un bucle de preparación o un planificador roto consuma todo el saldo de la integración de producción.
Conecta el gasto de crédito con la economía unitaria
Para una suscripción de consumidor, mide los créditos por cada espacio de trabajo activo gratuito y profesional, las comisiones de pago, los fallos de proveedores y la carga de soporte. Para el uso B2B, mide el gasto por cliente y por función. Los paquetes de crédito son unidades de uso prepago en lugar de dinero almacenado en la cuenta, por lo que tus precios deberían incluir una frecuencia realista de refrescos y un margen para intentos y datos incompletos del proveedor.