weimi-vending-api

Control Weimi-managed vending machines and retrieve protocol state via REST API.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/fxp/vending-protocol --skill weimi-vending-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weimi-vending-api
Source: https://github.com/fxp/vending-protocol/tree/main/devices/weimi-vending-api
Command: npx skills add https://github.com/fxp/vending-protocol --skill weimi-vending-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

It turns a Weimi-managed vending machine into an operational workflow an AI assistant can use to diagnose issues, test dispensing, and integrate with the platform without guesswork.

Core Features & Use Cases

  • Web and mobile operator guidance for navigating the admin consoles and finding the right test or repair action.
  • Third-party API integration for fetching device profiles, resolving aisle codes, placing shipments, and handling webhook callbacks.
  • Protocol troubleshooting for timeout errors, online and stock checks, and raw serial passthrough when lower-level control is needed.
  • Use case: A support agent can verify a machine, locate the correct aisle, trigger a safe test dispense, and confirm the result with order queries or webhook logs.

Quick Start

Ask me to help with a Weimi machine, and I will identify the device, resolve the correct aisle, and guide a safe dispense, repair, or API integration flow.

Frequently Asked Questions about weimi-vending-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate a Weimi vending machine with a third-party REST API?

To integrate a Weimi vending machine with a REST API, you must make signed API calls, perform device-info lookups before shipment, and use unique trade numbers. This Skill handles fetching profiles, resolving aisles, and placing shipments.

How do I troubleshoot a Weimi vending machine dispense timeout?

To troubleshoot a Weimi vending machine dispense timeout, use protocol troubleshooting for online and stock checks. You can also use raw serial command passthrough for lower-level control and order-query fallback to confirm the result.

How do I handle webhook callbacks for Weimi vending operations?

Handling webhook callbacks for Weimi vending operations involves managing third-party API integration flows. This Skill supports webhook handling to confirm dispense results and retrieve protocol state for cloud-managed dispensers.

Do I need to resolve aisle codes before triggering a Weimi machine dispense?

Yes, you need to resolve aisle codes and perform device-info lookups before triggering a Weimi machine dispense. This ensures the correct aisle is located for a safe test dispense or shipment operation.

Can I send raw serial commands directly to a Weimi vending machine?

Yes, you can send raw serial commands directly to a Weimi vending machine using the serial command passthrough feature. This is used for lower-level control when standard protocol troubleshooting is insufficient.

What is the best way to verify a Weimi vending machine shipment result?

The best way to verify a Weimi vending machine shipment result is by using order queries or checking webhook logs. This confirms whether the dispense operation completed successfully after placing the shipment.