![\"Tolinku](\"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/screenshot-routes-1772819856524.png\")
\nTolinku route configuration with QR code generation for each deep link.<\/em><\/p>\n\n\n\nTwo Approaches to Programmatic Links<\/h2>\n\n\n\n
There are two fundamentally different ways to create links at scale:<\/p>\n\n\n\n
1. Dynamic Routes (Pattern-Based)<\/h3>\n\n\n\n
Instead of creating individual links via API calls, you define a route pattern with parameters. Any URL matching the pattern automatically works as a valid deep link.<\/p>\n\n\n\n
For example, configure a route with the path No API call needed. Your backend constructs the URL by inserting the product identifier, and it works immediately. The This approach is ideal for:<\/p>\n\n\n\n Learn more about configuring dynamic routes<\/a> with parameters and wildcards.<\/p>\n\n\n\n For use cases where each link needs unique tracking or custom behavior, API-generated links provide full control. The most common example is referral links, where each user gets a unique code.<\/p>\n\n\n\n In Tolinku, referral links are created through the API:<\/p>\n\n\n\n Response:<\/p>\n\n\n\n Each call generates a unique code and a corresponding short link. The link is immediately active and trackable. See Referral Link Generation<\/a> for a deeper look at this workflow.<\/p>\n\n\n\n API requests require authentication via API keys. Tolinku uses two key types:<\/p>\n\n\n\n Publishable keys<\/strong> ( Secret keys<\/strong> ( Pass the key via the Alternatively, use the Here's how to construct short links programmatically in common languages, using the dynamic route approach.<\/p>\n\n\n\n When generating links via API, be aware of rate limits:<\/p>\n\n\n\n\/product\/:id<\/code> in your Tolinku dashboard<\/a>. Now every URL matching that pattern is a valid short link:<\/p>\n\n\n\ngo.yourapp.com\/product\/wireless-earbuds\ngo.yourapp.com\/product\/running-shoes\ngo.yourapp.com\/product\/laptop-stand\n<\/code><\/pre>\n\n\n\n:id<\/code> parameter is passed through to your app as deep link data, so your app knows which product to display.<\/p>\n\n\n\n![\"Tolinku](\"https:\/\/tolinku.com\/blog\/wp-content\/uploads\/2026\/03\/platform-platform-routes.png\")
\n
2. API-Generated Links (Per-Request)<\/h3>\n\n\n\n
curl -X POST https:\/\/your-domain.tolinku.com\/v1\/api\/referral\/create \\\n -H "X-API-Key: tolk_sec_your_secret_key" \\\n -H "Content-Type: application\/json" \\\n -d '{\n "user_id": "user_123",\n "user_name": "Jane Doe",\n "metadata": { "source": "share_screen" }\n }'\n<\/code><\/pre>\n\n\n\n{\n "referral_code": "ABC1234567",\n "referral_url": "https:\/\/go.yourapp.com\/ref\/ABC1234567",\n "referral_id": "doc_abc123"\n}\n<\/code><\/pre>\n\n\n\nAuthentication<\/h2>\n\n\n\n
tolk_pub_<\/code> prefix): Safe for client-side use. Limited to read-only operations and event tracking. Use these in your mobile SDK or web frontend.<\/p>\n\n\n\ntolk_sec_<\/code> prefix): Server-side only. Required for creating referral links, querying analytics, and other write operations. Never expose these in client-side code.<\/p>\n\n\n\nX-API-Key<\/code> header:<\/p>\n\n\n\ncurl -H "X-API-Key: tolk_sec_your_secret_key" \\\n https:\/\/your-domain.tolinku.com\/v1\/api\/endpoint\n<\/code><\/pre>\n\n\n\nAuthorization: Bearer<\/code> header. See the API Keys documentation<\/a> for setup instructions.<\/p>\n\n\n\nBuilding Links in Your Application Code<\/h2>\n\n\n\n
JavaScript\/TypeScript<\/h3>\n\n\n\n
function buildShortLink(routePrefix, token, domain = 'go.yourapp.com') {\n return `https:\/\/${domain}\/${routePrefix}\/${encodeURIComponent(token)}`;\n}\n\n\/\/ Product link\nconst productLink = buildShortLink('product', 'wireless-earbuds');\n\/\/ => https:\/\/go.yourapp.com\/product\/wireless-earbuds\n\n\/\/ User profile link\nconst profileLink = buildShortLink('user', 'jane-doe');\n\/\/ => https:\/\/go.yourapp.com\/user\/jane-doe\n<\/code><\/pre>\n\n\n\nPython<\/h3>\n\n\n\n
from urllib.parse import quote\n\ndef build_short_link(route_prefix, token, domain='go.yourapp.com'):\n return f'https:\/\/{domain}\/{route_prefix}\/{quote(token)}'\n\nproduct_link = build_short_link('product', 'wireless-earbuds')\n<\/code><\/pre>\n\n\n\nSwift (iOS)<\/h3>\n\n\n\n
func buildShortLink(routePrefix: String, token: String, domain: String = "go.yourapp.com") -> URL? {\n let encoded = token.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed) ?? token\n return URL(string: "https:\/\/\\(domain)\/\\(routePrefix)\/\\(encoded)")\n}\n\nlet productLink = buildShortLink(routePrefix: "product", token: "wireless-earbuds")\n<\/code><\/pre>\n\n\n\nKotlin (Android)<\/h3>\n\n\n\n
fun buildShortLink(routePrefix: String, token: String, domain: String = "go.yourapp.com"): String {\n val encoded = URLEncoder.encode(token, "UTF-8")\n return "https:\/\/$domain\/$routePrefix\/$encoded"\n}\n\nval productLink = buildShortLink("product", "wireless-earbuds")\n<\/code><\/pre>\n\n\n\nRate Limits and Usage Quotas<\/h2>\n\n\n\n