encurtador.dev

Choose language: English

Loading…

API console

Try the calls here, with your own credential, and see the API’s real response.

Heads up: the Create link tab creates real links and spends real credit. Every send is a real call, with a fresh idempotency key. Get links spends nothing.

Usage limit: 500 requests every 10 seconds, per IP. Going over blocks the IP for the next 10 seconds.

Credential

The key you type is never stored — not in localStorage, sessionStorage, a cookie or the URL. It lives in this form only and disappears when you reload the page.

POST /v1/links — creates the link and spends one credit.

A fresh idempotency key on every send

Request that will be sent

curl equivalent

Response

The raw response shows up here after you send.

Reference: error codes

The envelope is identical on every route. The message already comes translated according to the Accept-Language you sent; code is what your integration should test, and requestId is what lets support trace the call.

CodeHTTPWhat it means
INSUFFICIENT_CREDITS402Not enough balance to create the link.
AUTO_RECHARGE_FAILED402The automatic charge was declined; fix the card.
SLUG_UNAVAILABLE409The requested path is already taken.
URL_NOT_ALLOWED422The destination was rejected by the safety check.
API_KEY_LIMIT_REACHED409Active key limit reached; revoke one.
UNAUTHORIZED401Credential missing, invalid or expired.
API_KEY_REVOKED401The key used has been revoked.
SECURITY_PROVIDER_UNAVAILABLE503Check unavailable; no credit was spent.
PAYMENT_PROVIDER_UNAVAILABLE503Payment provider unavailable.
INVALID_REQUEST400Invalid body; see details.issues.
By continuing on this site, you agree to the use of our Cookie Policy . Read it to find out more.