API documentation

link.smrtspace.net — anonymous URL shortener

Transport

Endpoint: https://6wpail72ofzri3ziuiac5ajqncbkritr6xuvssghclelebfsvbum5cid.onion/api.php
Method: HTTP POST
Content-Type: application/json

Request format

{
  "method": "link_create",
  "params": { ... }
}

Response format

Success:

{ "result": { ... } }

Error:

{ "error": { "code": -32602, "message": "Invalid URL" } }

Error codes

CodeMeaning
-32600Invalid request format
-32601Method not found
-32602Invalid parameters
-32000Application error (see message)
-32603Internal server error

Methods

price

Returns current pricing. No parameters.

{ "method": "price", "params": {} }

Result:

{
  "per_hour":  "0.001",
  "currency":  "USDT",
  "min_hours": 1,
  "max_hours": 240
}

link_create

Create a short link. Requires a signed BB invoice for the exact amount.

ParamTypeDescription
urlsarrayOne or more target URLs (max 50). Redirect chosen randomly.
urlstringSingle target URL (alternative to urls)
hoursintLink lifetime in hours (1–240)
signed_invoiceobjectSigned BB invoice for per_hour × hours

Result:

{
  "slug":       "a3f9kz",
  "secret":     "e7c2...",
  "cn_url":     "https://link.smrtspace.net/?a3f9kz",
  "onion_url":  "https://<onion>/?a3f9kz",
  "expires_at": 1748000000,
  "receipt":    "..."
}

Save the secret — it is the only proof of ownership and cannot be recovered.
The receipt is an encrypted BB envelope. Decrypt with your private key to get the updated balance.

link_renew

Extend a link's expiration. Requires secret and a signed BB invoice.

ParamTypeDescription
slugstring
secretstringOwnership token
hoursintHours to add (1–240)
signed_invoiceobjectSigned BB invoice for per_hour × hours

Result: {"expires_at": 1748000000, "receipt": "..."}

link_update

Replace redirect targets. Requires secret. Free of charge.

ParamTypeDescription
slugstring
secretstringOwnership token
urlsarrayNew list of target URLs (max 50)

Result: {}

link_info

Get link details. Requires secret.

ParamTypeDescription
slugstring
secretstringOwnership token

Result:

{
  "slug":       "a3f9kz",
  "cn_url":     "https://link.smrtspace.net/?a3f9kz",
  "onion_url":  "https://<onion>/?a3f9kz",
  "urls":       ["https://example.com", "https://mirror.example.com"],
  "expires_at": 1748000000
}

link_delete

Delete the link permanently. Requires secret. No refund.

ParamTypeDescription
slugstring
secretstringOwnership token

Result: {}