API Reference
matrixorigin/memoria
Memoria REST API endpoints, request/response formats, auth, rate limits.
Look up Mobazha backend API endpoints, request/response formats, and field mappings.
Install API Reference
$ npx skills add mobazha/mobazha-unified --skill api-reference -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mobazha/mobazha-unified api-reference --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/api-reference .claude/skills/api-reference && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "api-reference" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/api-reference into .claude/skills/api-reference/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-reference", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/api-referenceType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mobazha/mobazha-unified --skill api-reference -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mobazha/mobazha-unified api-reference --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.cursor/skills/api-reference .agents/skills/api-reference && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "api-reference" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/api-reference into .agents/skills/api-reference/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-reference", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mobazha/mobazha-unified --skill api-reference -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mobazha/mobazha-unified api-reference --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.cursor/skills/api-reference .cursor/skills/api-reference && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "api-reference" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/api-reference into .cursor/skills/api-reference/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-reference", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mobazha/mobazha-unified.git --path .cursor/skills/api-reference--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mobazha/mobazha-unified --skill api-reference -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mobazha/mobazha-unified api-reference --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.cursor/skills/api-reference .gemini/skills/api-reference && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "api-reference" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/api-reference into .gemini/skills/api-reference/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-reference", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mobazha/mobazha-unified api-referenceInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mobazha/mobazha-unified --skill api-reference -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .github/skills && cp -r skills-src/.cursor/skills/api-reference .github/skills/api-reference && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "api-reference" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/api-reference into .github/skills/api-reference/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-reference", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mobazha/mobazha-unified --skill api-reference -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mobazha/mobazha-unified api-reference --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mobazha/mobazha-unified.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.cursor/skills/api-reference .opencode/skills/api-reference && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "api-reference" agent skill from https://github.com/mobazha/mobazha-unified/tree/main/.cursor/skills/api-reference into .opencode/skills/api-reference/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-reference", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
api-reference- GitHub stars
- 165
- Token cost
- ~1.7k tokens
- SKILL.md length
- 399 words
- Files
- 2
- Skills in repo
- 29
- Repo updated
- First seen
- Licence
- MPL-2.0
At a glance
Look up Mobazha backend API endpoints, request/response formats, and field mappings.
- Implementing API calls
- SKILL.md covers Architecture, Frontend API Layer, Backend Source Locations and Critical Field Notes, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Debugging API errors
What it does
API Reference is an agent skill from mobazha/mobazha-unified. Look up Mobazha backend API endpoints, request/response formats, and field mappings. Use when implementing API calls, debugging API errors, checking data structures, or when the user asks about API endpoints, backend structure, "API 接口", "后端接口", "字段映射", "数据结构".
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).
It sits in Backend & APIs, covering REST APIs and Structured output and tool calling. The repository describes itself as: Open-source commerce frontend for storefronts, marketplaces, checkout, and seller management. The licence is MPL-2.0.
When your agent uses it
- Implementing API calls
- Debugging API errors
- Checking data structures
- The user asks about API endpoints
Example prompts
- “API 接口”
- “/api-reference”
What it can do on your machine
Read from SKILL.md and the folder at commit 156c699. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
API Reference loads about 1.7k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 399 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from mobazha/mobazha-unified at commit 156c699, republished under its MPL-2.0 licence (© mobazha). 399 words, ~1,745 tokens.
Download SKILL.mdSave it as
.claude/skills/api-reference/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- api-reference
- description
- Look up Mobazha backend API endpoints, request/response formats, and field mappings. Use when implementing API calls, debugging API errors, checking data structures, or when the user asks about API endpoints, backend structure, "API 接口", "后端接口", "字段映射", "数据结构".
Mobazha API Reference
Architecture
[Frontend] → [mobazha_hosting (gateway)] → [mobazha (core node)]
↓
Some APIs handled directly
Some APIs proxied- mobazha_hosting: Hosting gateway — user management, group marketplace
- mobazha: Core P2P node — orders, products, wallets
Frontend API Layer
API 服务文件通过三层 helpers（packages/core/services/api/helpers.ts）统一路由，不直接调用
getGatewayUrl() / getAuthHeaders()。
| 层 | 函数前缀 | 路由目标 | 用途 |
|---|---|---|---|
| Layer 1 | auth* | getMyGatewayUrl() — 按角色路由 | 认证端点（orders, wallet, chat, notifications） |
| Layer 2 | public* | getGatewayUrl() — 始终本地节点 | 公开数据（listings, profiles, exchange rates） |
| Layer 3 | search* | getSearchUrl() — 搜索服务 | 搜索/发现（trending, featured） |
认证：getAuthHeaders() 从 getStoredToken() 获取 token（Bearer 或 basic: 前缀）。已移除
authCredentials 和 username/password 参数。
独立站角色路由：getMyGatewayUrl() 对独立站买家返回 getBuyerGatewayUrl()（→
SaaS），其他角色返回 getGatewayUrl()（→ 本地节点）。
mobazha 后端：Auth 中间件按路由粒度应用（auth() 闭包），公开路由无需认证。
Backend Source Locations
mobazha (Core Node — P2P)
| Data Type | File Path | Notes |
|---|---|---|
| Purchase | pkg/models/purchase.go | Order creation request |
| PurchaseItem | pkg/models/purchase.go | Order item |
| ListingMetadata | pkg/models/listings.go | Product index (with CID) |
| API Routes | internal/api/gateway.go | Route definitions |
| JWT Validator | internal/api/jwt_validator.go | Standalone JWT auth |
| Cert Fetcher | internal/net/cert_fetcher.go | SaaS cert retrieval |
| Order Handlers | internal/api/order_handlers.go | Order API |
| Listing Handlers | internal/api/listing_handlers.go | Product API |
| Protobuf Defs | pkg/orders/mbzpb/ | 订单/商品/通用 proto |
mobazha_hosting (Cloud Gateway)
| Data Type | File Path | Notes |
|---|---|---|
| Gateway Router | api/gateway.go | newHostingRouter() 路由注册 |
| Login Handlers | api/login*.go | Telegram/Discord/Web 登录 |
| Group Marketplace | api/group_*.go | 群组集市 API |
| Account Binding | api/account_handlers.go | 多平台账号绑定 |
| Encryption API | internal/services/encryption*.go | Phase2 加密密钥管理 |
| Relay Service | internal/services/relay*.go | Gas-less 交易中继 |
| Node Lifecycle | host/ | 节点创建/启动/GC |
| Store Registry | db/store_registry.go | 独立站注册/心跳/CRUD |
| Store Reg API | api/store_registry_handlers.go | 注册/心跳端点 |
| Cross-Store Proxy | api/cross_store_proxy.go | 四级路由代理中间件 |
| HTTPS Proxy | internal/services/store_proxy.go | Level 2 HTTPS 反向代理 |
| LibP2P Proxy | internal/services/libp2p_proxy.go | Level 3 LibP2P stream 代理 |
| Standalone Bind | api/standalone_bind_handlers.go | OAuth 绑定流程 |
| Auth Certificate | api/gateway.go handleGETAuthCertificate | Casdoor 公钥端点 |
Show full SKILL.md (183 more words)Show less
mobazha.info (Data Sync & Search)
| Data Type | File Path | Notes |
|---|---|---|
| Server + Routes | backend/internal/api/server.go | setupRoutes() 路由注册 |
| Search Handlers | backend/internal/api/search_handlers.go | 商品搜索 |
| Listing Handlers | backend/internal/api/listing_handlers.go | 商品索引 |
| Profile Handlers | backend/internal/api/profile_handlers.go | 用户资料 |
| NetDB Handlers | backend/internal/api/netdb_handlers.go | P2P 网络数据库 |
| Signature Verify | backend/internal/api/middleware.go | NetDB 签名验证 |
| SQLC Queries | backend/internal/db/sqlc/queries/ | 类型安全 SQL 查询 |
| Sphinx Search | backend/internal/services/sphinx.go | 全文搜索引擎 |
For complete API endpoint tables and data structures, see reference.md.
Critical Field Notes
listingHashmust be a CID (e.g.QmXxxx...), NOT a slugquantitymust be a string, not a number- Address fields are flat (not nested objects)
- No
vendorIdfield — backend resolves fromlistingHash - Product detail API doesn't return CID — get it from
listingindex
Storefront Config API (PG-201)
Store 品牌化配置端点，后端存储在 NodeSettings（key=store_config）。
| Method | Route | Auth | Description |
|---|---|---|---|
| GET | /v1/settings/storefront | Yes (owner) | 获取当前用户的 StoreConfig（含 draft） |
| PUT | /v1/settings/storefront | Yes (owner) | 全量替换 StoreConfig（后端做 JSON 结构校验，100KB 限制） |
| GET | /v1/settings/storefront/{peerID} | No (public) | 获取指定店铺的 StoreConfig（仅 status=published） |
前端 API 路径常量：packages/core/config/apiPaths.ts → NODE_API.SETTINGS_STOREFRONT /
NODE_API.SETTINGS_STOREFRONT_PUBLIC(peerID)
响应格式：标准 { data: StoreConfig } 信封。公开端点返回 null（无配置时 404）。
类型定义：packages/core/types/storeConfig.ts（Discriminated Union）。
详细 Schema 见 docs/features/PG-201_STORE_BRANDING_DESIGN.md。
Common Field Mapping
| Frontend | Backend | Notes |
|---|---|---|
address.name | shipTo | Recipient name |
address.street | address | Address line |
address.country | countryCode | Country code |
quantity (number) | quantity (string) | Must convert to string |
listingHash/cid | listingHash | Must be CID |
© mobazha, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in .cursor/skills/api-reference of mobazha/mobazha-unified.
- SKILL.md
- reference.md
Open the folder on GitHubat commit 156c699
Compare with similar skills
API Reference next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| API Reference this skillmobazha/mobazha-unified | 165 | — | ~1.7k | Automated safety check: Pass | MPL-2.0 | |
| API Referencematrixorigin/memoria | 607 | — | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| API Conventionshuangjia2019/claude-code-engineering | 1.1k | 1 repos | ~398 | Automated safety check: Pass | None | |
| REST API Designsecondsky/claude-skills | 227 | 1 repos | ~552 | Automated safety check: Pass | MIT | |
| Adynato Web APImajiayu000/claude-skill-registry | 666 | 1 repos | ~2k | Automated safety check: Pass | MIT | |
| RuView CLI, API and WASMruvnet/RuView | 97k | — | ~1.2k | Automated safety check: Notes | MIT |
Similar skills
API Conventions
huangjia2019/claude-code-engineering
API design patterns and conventions for this project. An agent skill from huangjia2019/claude-code-engineering.
REST API Design
secondsky/claude-skills
Designs RESTful APIs with proper resource naming, HTTP methods, status codes, and response formats.
Adynato Web API
majiayu000/claude-skill-registry
Web API development conventions for Adynato projects. An agent skill from majiayu000/claude-skill-registry.
RuView CLI, API and WASM
ruvnet/RuView
Covers the RuView `wifi-densepose` command line binary, its Axum REST API and the WebAssembly builds for browsers and ESP32, for embedding or scripting RuView.
REST API Contract Review
decebals/claude-code-java
Reviews REST API design for correct HTTP verbs, versioning, DTO use, consistent responses and backward compatibility before an API change ships.
More from mobazha/mobazha-unified
All 29 skills in this repoA11y Guide
mobazha/mobazha-unified
Accessibility guide for Mobazha following WCAG 2.1 AA standards including color contrast, reduced motion, ARIA patterns, keyboard navigation, focus management, and screen reader testing.
Code Review
mobazha/mobazha-unified
Review code for quality, architecture consistency, and adherence to Mobazha project standards using confidence-based filtering.
Code Simplifier
mobazha/mobazha-unified
Simplify and refine recently written code for clarity, consistency, and maintainability while preserving all functionality.
Commit Helper
mobazha/mobazha-unified
Generate commit messages and run pre-commit validation following Mobazha conventions.
Component Dev
mobazha/mobazha-unified
Create and modify UI components following Mobazha conventions including directory structure, spacing standards, accessibility, and testing.
Debug Troubleshoot
mobazha/mobazha-unified
Troubleshooting handbook for common issues in Mobazha development including build errors, Matrix connection issues, wallet problems, and performance debugging.
Related
Categories
Questions about API Reference
What does API Reference do?
Look up Mobazha backend API endpoints, request/response formats, and field mappings. API Reference is an agent skill from mobazha/mobazha-unified. Look up Mobazha backend API endpoints, request/response formats, and field mappings.
When should I use API Reference?
API Reference fits situations like: implementing API calls; debugging API errors; checking data structures; the user asks about API endpoints.
How do I install API Reference in Claude Code?
Run `npx skills add mobazha/mobazha-unified --skill api-reference -a claude-code`. Or copy the skill folder (.cursor/skills/api-reference in mobazha/mobazha-unified) into .claude/skills/api-reference in your project. Claude Code loads it when a task matches its description.
How do I install API Reference in Codex?
Run `npx skills add mobazha/mobazha-unified --skill api-reference -a codex`. Or copy the skill folder (.cursor/skills/api-reference in mobazha/mobazha-unified) into .agents/skills/api-reference in your project. Codex loads it when a task matches its description.
Can I use API Reference in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mobazha/mobazha-unified --skill api-reference -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-reference, .gemini/skills/api-reference, .github/skills/api-reference and .opencode/skills/api-reference in your project.
What does API Reference need to run?
SKILL.md names no scripts, command-line tools or credentials: API Reference is instructions for the agent only.
Does API Reference access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is API Reference safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does API Reference use?
API Reference is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does API Reference use?
About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to API Reference?
Skills that share tags, products or a category with API Reference: API Reference (matrixorigin/memoria, 607 stars), API Conventions (huangjia2019/claude-code-engineering, 1.1k stars), REST API Design (secondsky/claude-skills, 227 stars) and Adynato Web API (majiayu000/claude-skill-registry, 666 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains API Reference?
mobazha (a GitHub organization) maintains it in mobazha/mobazha-unified, which has 165 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 3, 2026.
Source: mobazha/mobazha-unified on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.