POST /create

Descrição: Cria links encurtados com controle de usuário.

Parâmetros:

• original_url (string, obrigatório): URL original
• type (string, obrigatório): "random" ou "custom"
• custom_code (string, opcional): Código personalizado (apenas se type="custom")
• token (string, obrigatório): JWT token de autenticação

Exemplo - Link Aleatório:

{
  "original_url": "https://exemplo.com",
  "type": "random",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Exemplo - Link Personalizado:

{
  "original_url": "https://exemplo.com",
  "type": "custom",
  "custom_code": "meulink",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Fluxo Básico Recomendado:

1. Para uso simples: Use /create_public diretamente
2. Para uso avançado: Implemente cache de token JWT para evitar logins repetidos
3. Para múltiplas URLs: Use /create_bulk para melhor performance
4. Tratamento de erros: Sempre verifique o campo success na resposta

Exemplo de Implementação Python:

import requests
import json

class MenorIOAPI:
    def __init__(self, base_url="https://menor.io"):
        self.base_url = base_url
        self.token = None

    def login(self, email, password):
        response = requests.post(f"{self.base_url}/auth", 
            json={"email": email, "password": password})
        data = response.json()
        if data.get("success"):
            self.token = data["data"]["token"]
            return True
        return False

    def shorten_url(self, url, custom_code=None):
        if custom_code:
            payload = {
                "original_url": url,
                "type": "custom",
                "custom_code": custom_code,
                "token": self.token
            }
            endpoint = "/create"
        else:
            # Para uso simples, sem autenticação
            payload = {"original_url": url}
            endpoint = "/create_public"

        response = requests.post(f"{self.base_url}{endpoint}", json=payload)
        data = response.json()

        if data.get("success"):
            return data["data"]["short_url"]
        else:
            raise Exception(data.get("message", "Erro desconhecido"))

# Uso:
# api = MenorIOAPI()
# short_url = api.shorten_url("https://exemplo.com/url-longa")
# print(short_url)  # https://menor.io/a1b2c3

Exemplo de Implementação JavaScript/Node.js:

class MenorIOAPI {
    constructor(baseUrl = "https://menor.io") {
        this.baseUrl = baseUrl;
        this.token = null;
    }

    async login(email, password) {
        const response = await fetch(`${this.baseUrl}/auth`, {
            method: 'POST',
            headers: {'Content-Type': 'application/json'},
            body: JSON.stringify({email, password})
        });

        const data = await response.json();
        if (data.success) {
            this.token = data.data.token;
            return true;
        }
        return false;
    }

    async shortenUrl(url, customCode = null) {
        let payload, endpoint;

        if (customCode && this.token) {
            payload = {
                original_url: url,
                type: "custom",
                custom_code: customCode,
                token: this.token
            };
            endpoint = "/create";
        } else if (this.token) {
            payload = {
                original_url: url,
                type: "random",
                token: this.token
            };
            endpoint = "/create";
        } else {
            // Uso público sem autenticação
            payload = {original_url: url};
            endpoint = "/create_public";
        }

        const response = await fetch(`${this.baseUrl}${endpoint}`, {
            method: 'POST',
            headers: {'Content-Type': 'application/json'},
            body: JSON.stringify(payload)
        });

        const data = await response.json();
        if (data.success) {
            return data.data.short_url;
        } else {
            throw new Error(data.message || "Erro desconhecido");
        }
    }
}

// Uso:
// const api = new MenorIOAPI();
// const shortUrl = await api.shortenUrl("https://exemplo.com/url-longa");
// console.log(shortUrl); // https://menor.io/a1b2c3