Опублікуйте потік даних: хай ваш віджет працює без вашого ключа

У поширенні зяяла незручна дірка. Ви збираєте гарний графік FX на своєму підключенні до OANDA, публікуєте його — і перший, хто його встановив, читає Підключіть OANDA, щоб використовувати ці дані. Це ввічливий спосіб попросити незнайому людину відкрити брокерський рахунок заради того, щоб подивитися на графік. На живому екрані було ще гірше: віджет застигав мініатюрою.

Розв’язок — не позичати комусь ключ. Розв’язок — опублікувати ті читання, які ваш віджет справді виконує, як окремі ендпоїнти під вашим власним профілем:

GET /<ім'я-користувача>/api/w/<widget>/<endpoint>?symbol=EUR_USD&interval=H1

Вмикається у вікні публікації — Опублікувати потік даних лише для читання — і ті, хто не має власного підключення, читають ваш потік замість прохання підключитися.

Три правила, і кожне з них — відмова

Лише читання, якими безпечно ділитися. Публікувати можна тринадцять методів даних. Решта заблокована, кожен зі своєї причини: account і positions теж читання, але повертають ваш баланс, вартість активів, прибутки-збитки й відкриті позиції. order і closePosition рухають гроші. upsert і delete руйнують дані. scrape тарифікується третьою стороною за кожен виклик. А голий http і так без облікових даних: опублікувати його — означає просто побудувати відкритий проксі з вашим іменем.

Лише ті виклики, які віджет справді зробив. Успішні читання вашого віджета записуються під час його роботи, і вікно публікації показує вам список — свічки з Binance — BTCUSDT, 1h — як ту конкретну річ, з якою ви погоджуєтеся. Запит, що вимагає параметр, якого ви ніколи не публікували, або значення поза множиною, до якої ви його розширили, відхиляється до того, як щось буде розшифровано. Параметри, яким нема чого робити в URL — SQL-запит, вектор, — там ніколи не з’являються: вони відтворюються дослівно зі сховища.

Відмови нерозрізненні. Неіснуючий ендпоїнт, параметр поза своїм списком і авдиторія, до якої ви не належите, повертають однаковий 404. Сам факт існування потоку «лише для друзів» — це вже інформація про автора, і відповідь ніколи її не видає.

Хто може читати і в що це обійдеться

Авдиторія — не четвертий перемикач, про який можна забути: вона йде за оголошенням — усі, ваші підписники або ваші друзі. Приватне оголошення вимикає потік цілком, бо оголошення, яке бачите тільки ви, за ендпоїнтом, який викликають інші, просто не тримається купи.

Вартість — та частина, яку варто зрозуміти, бо саме її бояться. Ви обираєте інтервал оновлення — кожні 30 секунд, 5 хвилин, щогодини чи щодня — і це максимум, з яким використовуватиметься ваше підключення, скільки б людей не відкрило віджет. Ті, хто читає, ділять одну кешовану копію. Десять глядачів і десять тисяч дають однакову кількість звернень, а на одне вікно дозволено рівно одне оновлення, навіть якщо кілька читачів схибили повз кеш тієї самої миті.

Ваш ключ ніколи не покидає сервер. Баланс, позиції та ордери не публікуються ніколи. А потік прив’язаний до картки: зніміть віджет з публікації — і ендпоїнти перестають відповідати.

Власне підключення глядача завжди перемагає

Опублікований потік — запасний варіант, а не заміна. Якщо той, хто відкриває ваш віджет, має власне підключення до OANDA, віджет використовує його: його рахунок, його дані, його ліміти. До потоку звертаються лише після того, як віджет не знайшов власного підключення, і промах стається мовчки: людина бачить звичне підключіть цей майданчик замість нової помилки, яку довелося б вивчати.

Ці ендпоїнти йдуть через ті самі адаптери майданчиків, що вже є в застосунку, тож опублікований потік повертає точно ті самі форми, які ви бачили, коли збирали віджет, — по всіх активних майданчиках каталогу й без окремого коду під кожен.

Чого він навмисно не робить

• Спільна торгова панель намалює графік, але не панель рахунку. Це працює список заборон, а не вада.
• Вибір символів запропонує лише ті символи, які ви перелічили. Віджет із вільним введенням зводиться до фіксованого набору. Це ціна за те, щоб не будувати відкритий проксі до вашого брокера.
• У приватному режимі потік опублікувати не можна. Там ваші облікові дані живуть лише в печатці цього пристрою: жоден сервер їх не тримає, а отже, жоден не може оновлювати щось від вашого імені.
• Форк не успадковує потік. Потоки прив’язані до родоводу віджета: кожна встановлена копія розв’язується в ті самі ендпоїнти, а форк — у жоден.

Увімкнути — дрібниця, але вона змінює зміст публікації: віджет, яким ви ділитеся, тепер віджет, який люди справді можуть запустити.

Відкрийте Nexow, візьміть віджет, зібраний на підключенні з ключем, і опублікуйте його з увімкненим потоком.