Skip to main content
AceDataCloud actualmente no tiene un endpoint agregado /api/v1/distribution/. Los datos de recompensas por recomendación constan de cuatro grupos de interfaces: estado, historial, niveles y canje; llame según el recurso necesario y evite depender de una respuesta resumida que no existe.

​
Preparativos

  1. Cree y guarde un Account Token en la consola de Account Token.
  2. Utilice GET /api/v1/platform-tokens/me/ para obtener el UUID de la cuenta actual.

​
Interfaces disponibles

​
Ejemplos de solicitudes de solo lectura

La forma de respuesta validada en línea es:
  • status, history, level, redemption list: {count, items};
  • redemption preview: un único objeto, que contiene campos como eligible, reason, reward_amount, credit_amount, credits_per_usd, currency, package, global_application, entre otros.
Los elementos de estado y de historial se ampliarán según el control de riesgos de recomendaciones, las compensaciones y las reglas de recompensas; el cliente debe leer según sea necesario y no depender de campos agregados como referral_url, recent_orders, withdrawable_balance, entre otros, que se mencionan en documentación antigua pero no son devueltos por la interfaz.
Tanto la inicialización como el canje son operaciones de escritura. Los scripts de producción deben primero llamar a las interfaces de solo lectura para comprobar el estado y persistir un idempotency_key único para las solicitudes de canje; no reintente automáticamente canjes con resultados desconocidos.

​
Páginas relacionadas

​
Pedidos con sobreprecio de subestaciones

Para los pedidos de subestaciones a los que se aplican las nuevas reglas, la comisión por recomendación se calcula sobre el precio base después del descuento, y la diferencia del sobreprecio después del descuento pertenece íntegramente al webmaster en el momento de creación del pedido. Las dos partes de la recompensa del mismo beneficiario se combinan en el registro de distribución original, y el historial de distribución mostrará su composición; los pedidos sin sobreprecio y los pedidos históricos mantienen las reglas originales. Por ejemplo, con un precio base de 100 y un precio de 120 después del sobreprecio, si el webmaster es al mismo tiempo el único recomendador y la proporción es del 10 %, la recompensa de este pedido será 10 + 20 = 30. Cuando el webmaster y el recomendador no son la misma persona, ambos reciben respectivamente las recompensas correspondientes. La liquidación en efectivo sigue siendo gestionada manualmente por la plataforma. La plataforma deducirá el importe disponible de esta vez de la cuenta de recompensas original y luego realizará el pago manual; la parte ya canjeada por créditos no puede volver a pagarse en efectivo. Si después de un reembolso aparece un saldo negativo de recompensas, primero se compensará con recompensas posteriores.