REST API v1.0 • High-Speed Edge Network
SDdev Developer API
Programmatically create short links, access cloud processing utilities, and integrate our edge infrastructure directly into your applications.
Interactive API Playground
Test the live URL Shortener endpoint directly from your browser.
POST
/api/v1/shortenResponse
Press "Send API Request" to see the live server response.
🔐 Authentication
All API requests require authentication using your personal developer API key. You can pass your key in one of three ways:
Header: x-api-key (Recommended)
x-api-key: sddev_xxxxxxxxxxxx
Header: Authorization Bearer
Authorization: Bearer sddev_xxxxxxxx
Body or Query Parameter
"apiKey": "sddev_xxxxxxxx"
Endpoint Reference
Specifications and parameter details for our developer endpoints.
POST
Costs 1 Credit
/api/v1/shorten
Request Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
| destinationUrl | string | Yes | The destination target URL or custom deep link (supports https://, http://, and custom schemes like upi://, ftp://, mailto:, tg://, etc.). Also accepts url. |
| title | string | Optional | A descriptive name or title for tracking this shortened link. |
| urlPath | string | Optional | Custom alias (3-30 chars, letters, numbers, dash/underscore). If omitted, a random 12-character mixed alphanumeric code is generated automatically. |
| apiKey | string | Header / Body | Your account API key (optional in body if supplied via x-api-key or Bearer header). |
HTTP Status Codes
201 Created Link created successfully with full shortened URL and remaining credit balance.
400 Bad Request Invalid destination URL format or invalid characters in custom path.
401 Unauthorized Missing or invalid API key.
402 Payment Required Insufficient account credits (1 credit required).
409 Conflict The requested custom URL path is already in use by another link.
429 Too Many Requests Monthly API credit limit reached. Manage cap in Dashboard API settings.