apiproxyd Documentation

On-Premises API Caching Daemon

Quick Navigation

Overview Installation Configuration Usage Integrations

Overview

apiproxyd is a high-performance API caching daemon that enables businesses to deploy on-premises caching infrastructure for api.apiproxy.app. Reduce API costs by up to 90% and improve response times from 200ms to under 5ms.

High Performance

Built in Go, handles 10K-100K cached requests/sec with gRPC clustering

Dual Cache Backends

SQLite for single-server, PostgreSQL for distributed multi-server

Enterprise Security

API keys, OAuth2, LDAP/Active Directory, TLS 1.2+, rate limiting

Enterprise Integrations

Infoblox NIOS, BlueCat Address Manager, LDAP, cloud vendors

Note: apiproxyd is available for Government, Enterprise, and Custom pricing tiers. Contact sales to add it to your plan.

Installation

Using Go

go install github.com/afterdarksys/apiproxyd@latest

Clone and Build

git clone https://github.com/afterdarksys/apiproxyd.git
cd apiproxyd
make build

Using the Installer

python3 install.py

Docker

# Build image
make docker-build

# Run container
docker run -p 9002:9002 \
  -v $(pwd)/config.json:/app/config.json:ro \
  apiproxyd:latest

Configuration

Create a config.json file:

{
  "server": {
    "host": "127.0.0.1",
    "port": 9002
  },
  "entry_point": "https://api.apiproxy.app",
  "api_key": "apx_live_your_key_here",
  "cache": {
    "backend": "sqlite",
    "path": "~/.apiproxy/cache.db",
    "ttl": 86400
  },
  "offline_endpoints": ["/v1/darkapi/ip/*", "/health"],
  "whitelisted_endpoints": ["/v1/darkapi/*", "/v1/nerdapi/*"]
}

Configuration Reference

Field	Type	Description	Default
server.host	string	Listen address	127.0.0.1
server.port	int	Listen port	9002
api_key	string	Your API key	(required)
cache.backend	string	sqlite or postgres	sqlite
cache.ttl	int	Cache TTL (seconds)	86400 (24h)

Usage

Authentication

# Interactive login
apiproxy login

# Login with API key
apiproxy login --api-key apx_live_xxxxx

Daemon Management

apiproxy daemon start     # Start background service
apiproxy daemon stop      # Stop daemon
apiproxy daemon status    # Check daemon status
apiproxy daemon restart   # Restart daemon

Making API Requests

# Using CLI
apiproxy api GET /v1/darkapi/ip/8.8.8.8

# Using HTTP proxy
curl http://localhost:9002/api/v1/darkapi/ip/8.8.8.8 \
  -H "X-API-Key: apx_live_xxxxx"

Monitoring

# Health check
curl http://localhost:9002/health

# Cache statistics
curl http://localhost:9002/cache/stats

Enterprise Integrations

apiproxyd includes production-ready plugins for enterprise DDI (DNS, DHCP, IPAM) systems and authentication:

Infoblox NIOS/WAPI Plugin

Complete caching support for Infoblox Network Identity Operating System (NIOS) and WAPI API.

Network objects: 1 hour TTL
DNS records: 5 minutes TTL
DHCP leases: 2 minutes TTL
Grid configuration: 30 minutes TTL
Identity-independent caching (strips auth cookies)
Automatic mutation detection

BlueCat Address Manager Plugin

Full support for BlueCat Address Manager (BAM) and BDDS REST API caching.

Configuration objects: 1 hour TTL
DNS zones and records: 5 minutes TTL
DHCP ranges: 2 minutes TTL
Entity searches: 10 minutes TTL
Deployment status: 30 seconds TTL
Mutation detection for add/update/delete operations

LDAP/Active Directory Authentication

Enterprise directory integration for centralized authentication and authorization.

Connection pooling (default: 10 connections)
TLS/SSL support (LDAPS and StartTLS)
Group membership validation
Authentication result caching
HTTP Basic Auth integration
Automatic connection health checks

Cloud Vendor APIs

Pre-built plugins for major cloud platforms and services.

AWS SigV4 proxy with identity-aware caching
Docker Registry (OCI) with immutable blob caching
Kubernetes cache with materialized views
Stripe, Twilio, OpenAI integrations

Custom Plugins: Need support for a different API or system? apiproxyd's plugin system makes it easy to add custom integrations. See our plugin development guide or contact sales for custom development.

Performance Benchmarks

SQLite Backend

Cache Hit: <5ms
Throughput: 10K-100K req/sec
Storage: ~1KB per response

PostgreSQL Backend

Cache Hit: ~10ms
Throughput: Scales horizontally
Storage: Unlimited capacity

Need Help?

Our team is here to help you deploy and optimize apiproxyd for your infrastructure

Contact Support GitHub Issues