Developer Hub

URL shortening built for your code.

Create short links from your terminal, code, or background workers with sub-15ms redirects, zero monthly caps, and our official TypeScript SDK.

Install via package manager:

bash

pnpm add @g/shortyy

TypeScript First

Strictly typed request parameters, response models, and categorized error contracts.

index.ts

import { createShortyy } from "@g/shortyy";

const shortyy = createShortyy({
  apiKey: process.env.SHORTYY_API_KEY!,
  defaultExpiresIn: "24h",
});

// Create a short link in one line
const link = await shortyy.links.create({
  url: "https://github.com/developer/project",
});

console.log("Short URL:", link.shortUrl);
console.log("Expires At:", link.expiresAt);

Developer Architecture

Built from first principles for reliability, security, and low latency.

Hashed Credentials

Production API keys use the sh_live_ prefix. Raw keys are never stored; verification checks SHA-256 digests in Upstash Redis.

Token-Bucket Rate Limits

4 token burst capacity with continuous refill (1 token every 75s). Never suffer rigid monthly quota lockouts; rate limits recover automatically.

Sub-15ms Redirects

Fastify and Upstash Redis serve redirects directly from memory with HTTP 307 temporary redirects, preserving caching headers and POST payloads.

API Key Management

Issue scoped API credentials with granular expiration horizons.

SDK Reference

Full client options, error subclasses, and retry semantics.

Code Examples

Recipes for Python, Go, Java, PHP, and cURL integrations.

REST API Playground

Interactive request runner, headers, status codes, and JSON schemas.