Skills
.Work. You
Rest

blong-rest

Official

Define REST APIs in Blong with OpenAPI support.

Software Engineering#rest#OpenAPI#Swagger#JSON-RPC#adapter#gateway#api-merge
Authorfeasibleone
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Blong's default API runtime is JSON-RPC. This Skill enables teams to implement pre-defined REST APIs using OpenAPI/Swagger contracts while preserving Blong's gateway and adapter patterns for a consistent API surface.

Core Features & Use Cases

  • REST Server: Expose REST endpoints from OpenAPI specs via gateway at /rest/{namespace}/...
  • REST Client: Call external REST APIs using OpenAPI definitions through the HTTP adapter
  • API Merging: Merge multiple OpenAPI specs into a single namespace for maintainability
  • Standards Compliance: Enforce OpenAPI contracts and operationId-based handler mapping
  • Gateway Integration: Integrates REST with the existing JSON-RPC flow

Quick Start

  • Define a gateway/api/ namespace for the REST API and attach an OpenAPI YAML spec with operationId
  • Create the OpenAPI YAML describing endpoints under paths with operationId
  • Implement handlers under orchestrator named by the namespace and operationId
  • Update the realm server configuration to enable REST gateway and route /rest requests

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: blong-rest
Download link: https://github.com/feasibleone/blong/archive/main.zip#blong-rest

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.