Плагин получает заказ, может спросить данные у покупателя, обратиться к внешнему API и вернуть результат. Он не получает прямой доступ к базе, env, токенам пользователей, файлам сервера и основному Node.js процессу.
Manifest и source code сначала хранятся как данные. Сторонний код нельзя подключать через require/import в основной процесс сайта. Live-исполнение должно идти только через sandbox и host API.
Starvell, YooMarket или GGSEL. От этого зависит, какие поля заказа и действия доступны.
Название, версия, цена, площадки, permissions и entrypoint. Без manifest пакет не попадет на проверку.
Код хранится как текст и проходит static/sandbox/AI review. Он не исполняется в основном процессе сайта.
Система покажет замечания. После чистой проверки админ публикует версию в marketplace.
Ниже практический список: scope для manifest, обязательный permission, поля заказа и действия, которые можно вызывать через host API.
Автоматизация заказов, чатов, лотов, статусов, отзывов и выдачи.
ctx.sendMessage(text)ctx.fetch(url, options)ctx.markCompleted()ctx.storage.get/setАвтоматизация заказов, чатов, лотов и API магазина YooMarket.
ctx.sendMessage(text)ctx.fetch(url, options)ctx.storage.get/setАвтоматизация товаров, заказов, сообщений, отзывов и выдачи GGSEL.
ctx.sendMessage(text)ctx.fetch(url, options)ctx.storage.get/setManifest описывает карточку плагина, версию, цену, площадки, права и точку входа. Если поле заполнено неверно, форма покажет понятную ошибку до публикации.
{
"schemaVersion": 2,
"pluginId": "my-provider-topup",
"version": "1.0.0",
"displayName": "My Provider Topup",
"description": "Автовыдача через внешний provider API.",
"marketplaceScope": ["starvell"],
"category": "topup",
"pricing": {
"type": "monthly",
"priceRub": 799,
"period": "month",
"trialDays": 3
},
"permissions": [
"orders.read",
"chat.send",
"orders.complete",
"network.fetch",
"marketplace.starvell"
],
"settingsSchema": {},
"fixtures": [],
"entrypoint": "index.ts",
"changelog": "Первая версия"
}Минимальный плагин должен уметь определить свой заказ и вернуть понятный результат. Закрывайте заказ только после успешной выдачи.
export async function matchOrder(ctx) {
// true означает: этот заказ должен обрабатывать ваш плагин
return ctx.order.lotId === 123456
}
export async function dialogSteps(ctx) {
return []
}
export async function execute(ctx) {
await ctx.sendMessage("Заказ принят в работу.")
const result = await ctx.fetch("https://provider.example/api/order", {
method: "POST",
body: {
login: ctx.order.buyerName,
quantity: ctx.order.quantity
}
})
if (!result.ok) {
return {
success: false,
message: "Provider не подтвердил выдачу"
}
}
await ctx.markCompleted()
return {
success: true,
message: "Товар выдан, заказ закрыт"
}
}Заявка подается из кабинета разработчика. После отправки вы увидите статус проверки, findings и историю версий.
Открыть кабинет разработчика