Skip to main content
Наразі AceDataCloud не має агрегованого ендпойнта /api/v1/distribution/. Дані про реферальні винагороди складаються з чотирьох груп API: статус, історія, рівні та обмін; викликайте відповідно до потрібного ресурсу, не покладайтеся на неіснуючу зведену відповідь.

Підготовка

  1. Створіть і збережіть Account Token у консолі Account Token.
  2. Використайте GET /api/v1/platform-tokens/me/, щоб отримати UUID поточного облікового запису.

Доступні API

Приклади запитів лише для читання

Форма відповіді, перевірена в робочому середовищі:
  • status, history, level, redemption list: {count, items};
  • redemption preview: окремий об’єкт, що містить поля eligible, reason, reward_amount, credit_amount, credits_per_usd, currency, package, global_application та інші.
Елементи статусу й історії можуть розширюватися відповідно до контролю ризиків рекомендацій, компенсацій і правил винагород; клієнти мають читати за потреби та не покладатися на агреговані поля referral_url, recent_orders, withdrawable_balance та інші, які в старій документації не повертаються API.
Ініціалізація та обмін є операціями запису. Виробничі скрипти повинні спочатку викликати API лише для читання, щоб перевірити статус, і зберігати унікальний idempotency_key для запиту обміну; не повторюйте автоматично обмін із невідомим результатом.

Пов’язані сторінки

Замовлення з націнкою субсайту

Для замовлень субсайтів, до яких застосовуються нові правила, реферальна комісія розраховується на основі базової ціни після знижки, а різниця націнки після знижки повністю належить власнику сайту на момент створення замовлення. Дві частини винагороди одного й того самого отримувача об’єднуються в початковий запис розподілу, а історія розподілу відображатиме їхній склад; замовлення без націнки та історичні замовлення зберігають початкові правила. Наприклад, якщо базова ціна становить 100, а після націнки — 120, власник сайту водночас є єдиним реферером, а коефіцієнт становить 10%, винагорода за це замовлення становить 10 + 20 = 30. Якщо власник сайту та реферер не є однією особою, кожен із них отримує відповідну винагороду. Грошові розрахунки, як і раніше, здійснюються платформою вручну. Платформа вручну здійснює виплату після зменшення доступної суми цього разу на початковому рахунку винагород; частина, уже обміняна на кредити, не може бути повторно виплачена готівкою. Якщо після повернення коштів виникне дефіцит винагороди, він спочатку буде погашений за рахунок наступних винагород.