SuperBins Logo

What is a Bin?

A bin is a JSON storage endpoint that you can manipulate to return different responses. Think of it as your own customizable API endpoint.

The Basics

At its core, a bin is a JSON store that responds to HTTP requests with the data you've configured. When you create a bin, you're essentially creating a custom API endpoint that can return any JSON data you want.

Simple Example

You store JSON data in a bin, and SuperBins gives you a URL where that data is accessible:

Your JSON data:
{
  "message": "Hello World",
  "status": "success",
  "data": {
    "user": "John Doe",
    "role": "developer"
  }
}
Accessible at:
https://www.superbins.io/api/b/your-bin-id

Key Features of Bins

Instant API Endpoints

Every bin gets its own unique URL that responds to HTTP requests immediately.

GET /api/b/abc123

Dynamic Responses

Use conditions and token replacement to create intelligent, context-aware responses.

{{random.name}}

Version Control

Update your bin's content anytime through the web interface. Changes are reflected immediately.

Access Control

Make bins public for open access or private with API key authentication.

Common Use Cases

Frontend Development

Create mock API responses while your backend is still in development. No need to wait for real APIs.

Testing & QA

Simulate different API responses including error states, edge cases, and various data scenarios.

Demos & Prototyping

Quickly set up realistic data for demos, presentations, or proof-of-concept applications.

API Documentation

Provide working examples alongside your API documentation that developers can test immediately.

How Bins Work

  1. 1. Create: Add JSON data through the SuperBins dashboard
  2. 2. Configure: Set up conditions, token replacement, or other advanced features
  3. 3. Access: Use the provided URL in your applications or tests
  4. 4. Update: Modify the bin's content anytime - changes are instant

Example HTTP Request

curl -X GET "https://www.superbins.io/api/b/abc123" \
     -H "X-Bin-Access-Key: your-access-key"

Beyond Simple JSON Storage

While bins start as simple JSON stores, they become powerful when you add:

  • • Token Replacement: Dynamic data generation with realistic fake data
  • • Conditional Logic: Different responses based on request parameters
  • • Collections: Organized grouping of related bins
  • • Access Control: Public or private bins with API key authentication

Ready to Create Your First Bin?

Start by creating a simple bin and see how easy it is to get your own API endpoint.

Create a Bin