Skip to content


Super·interface: Abstraction layer on top of APIs for autonomous API discovery and integration.

A modern DSL for API integrations

npm packages Twitter profile Discord server

Welcome to Superface

API integrations take forever to build. They’re brittle and hard to test. APIs can change on you without notice and break your integrations.

Superface changes this. If your Node.js app depends on multiple API integrations, Superface is the right solution for you!

The motivation behind Superface is described in this video from APIdays conference.

How it works

Superface is a language and a protocol for abstracting integrations to application use-cases. It allows use-case discovery and distribution of integration code at runtime.

This approach gives you a framework to decouple lifecycle of your application and integrations it uses.

Superface has two parts:

  • Registry for use-case discovery and distribution of integration code at runtime
  • Client for executing the integration code in your application

Superface does not rely on any proxy. There is no integration middleman between your application and the APIs it uses.

You can read more about Superface on its homepage and in the documentation.

Get started

Superface protocol can be implemented in any language. The first production-ready implementation is in Node.js. For more details check OneSDK repository.


  1. one-sdk-js Public

    1️⃣ One Node.js SDK for all the APIs you want to integrate with

    TypeScript 40 2

  2. station Public

    Comlink metadata for self-integrating applications.

    TypeScript 17 5

  3. cli Public

    Do not program API integrations! Install them.

    TypeScript 17 1

  4. docs Public & Comlink documentation.

    JavaScript 12 2

  5. spec Public

    The Comlink Specification. Comlink is a new interface description and integration language build self-integrating applications.


  6. VS Code extension for the Comlink language.

    TypeScript 11 2


Top languages


Most used topics