Criar link curto

POST

/v1/links/shorten

O slug é sempre gerado pela SMSGo (7 caracteres); um slug enviado no corpo é ignorado. Use o short_url da resposta. Exige a assinatura do módulo de links curtos. Sujeito a rate-limit (429).

Requisição

Authorization

Bearer Token

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonObrigatório

Exemplo

{
    "url": "https://meusite.com.br/campanha/black-friday?utm_source=sms",
    "title": "Black Friday 2026",
    "expires_at": "2026-11-30T23:59:00-03:00"
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/links/shorten' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://meusite.com.br/campanha/black-friday?utm_source=sms",
    "title": "Black Friday 2026",
    "expires_at": "2026-11-30T23:59:00-03:00"
}'

Respostas

🟢201

application/json

Link criado

Bodyapplication/json

Exemplo

{
    "id": 42,
    "slug": "k7m2qx9",
    "short_url": "https://sgo.ad/k7m2qx9",
    "destination_url": "https://meusite.com.br/campanha/black-friday?utm_source=sms",
    "title": "Black Friday 2026",
    "status": "active",
    "expires_at": null
}

🟠422

🟠401Unauthorized

🟠403ModuleNotSubscribed

🟠429TooManyRequests

Modificado em 2026-10-17 14:54:15