SmallPlate

Resolve and Redirect

Resolve short links to destination URLs

Plate-Link supports two resolution styles:

  • JSON resolve (recommended for custom domain routing)
  • direct redirect endpoint

JSON resolve endpoint

GET /{plateId}/resolve/{id}
GET /{plateId}/resolve/{id}/{tail...}

This endpoint has CORS enabled (Access-Control-Allow-Origin: *).

Example response:

{
  "ok": true,
  "data": {
    "id": "dyn_z8A1c",
    "plate_id": "1",
    "destination": "https://shop.example.com/product/test?ref=google",
    "status": "ok",
    "uses": 18
  }
}

Redirect endpoint

GET /url/{id}
GET /url/{id}/{tail...}

Returns an HTTP redirect (temporary redirect).

Dynamic examples

Positional placeholders

Template:

https://mycoolwebsite.com/product/{}?ref={}

Request:

GET /url/{id}/test/google

Destination:

https://mycoolwebsite.com/product/test?ref=google

Named placeholders

Template:

https://test.com/{product}

Request:

GET /url/{id}?product=test

Destination:

https://test.com/test

Failure cases

  • 404 not_found if ID does not exist
  • 410 disabled if link disabled
  • 410 expired if expired
  • 410 max_uses_reached if usage limit reached

Framework examples

For full code by language:

On this page