Para desenvolvedores

API de chaves de licença

Ligue "Gerar uma chave de licença para cada venda" num produto de arquivo da sua Loja. Cada compra recebe uma chave, e o seu software confere a chave nesta API.

Como funciona

  • O comprador recebe a chave no e-mail da compra e na página do pedido.
  • Na primeira vez, o software chama activate com a chave e um identificador do aparelho. Repetir no mesmo aparelho não gasta outra vaga.
  • Depois, chame validate de tempos em tempos (a cada poucos dias basta) e aceite um período sem internet.
  • Reembolso ou contestação perdida cancelam a chave na hora. Você também desativa, reativa e libera aparelhos pelo pedido no painel.
  • Não há segredo para guardar no software: a chave e o ID do produto bastam, e a API limita as tentativas.

Endpoints

Todos são POST com Content-Type: application/json e corpo de até 1 KB. A API é para programas instalados: chamadas feitas de páginas web são recusadas.

  • https://www.likiro.com/api/v1/licenses/activate: ativa a chave neste aparelho.
  • https://www.likiro.com/api/v1/licenses/validate: confere a chave. Com fingerprint, confere também se o aparelho está ativado.
  • https://www.likiro.com/api/v1/licenses/deactivate: libera este aparelho, para o comprador usar outro.

Campos

license_key
A chave que o comprador digitou, como LK-XXXXX-XXXXX-XXXXX-XXXXX. Maiúsculas e espaços nas pontas não importam.
product_id
O ID do seu produto, no painel do produto em "ID do produto para a API".
fingerprint
Um identificador estável do aparelho, de 16 a 128 caracteres (letras, números, - e _). Obrigatório em activate e deactivate.
device_name
Opcional, só em activate. O nome que o comprador vê na lista de aparelhos (até 64 caracteres).

Exemplo

curl -X POST https://www.likiro.com/api/v1/licenses/activate \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "LK-7K3QM-9TXW2-HB4RD-Z6YNP",
    "product_id": "SEU_PRODUCT_ID",
    "fingerprint": "id-estavel-do-aparelho",
    "device_name": "DESKTOP-01"
  }'

Sucesso responde 200. activation_limit é null quando a chave não tem limite de aparelhos, e activation é null no validate sem fingerprint e no deactivate.

{
  "data": {
    "license": { "status": "active", "activation_limit": 1, "activation_count": 1 },
    "activation": { "id": "…", "device_name": "DESKTOP-01", "created_at": "2026-11-01T12:00:00.123456+00:00" },
    "product": { "id": "…", "title": "Meu Software" }
  }
}

Erros

Todo erro vem como { "error": "<código>" }.

HTTPCódigoQuando
400bad_requestCorpo inválido, campo faltando ou chamada sem Content-Type JSON.
404not_foundA ação do endereço não existe.
404invalid_licenseA chave não existe ou é de outro produto.
403license_disabledVocê desativou a chave no painel.
403license_revokedA compra foi reembolsada ou contestada.
403membership_inactiveChave de resgate de membro, e o membro saiu do nível.
409activation_limit_reachedTodos os aparelhos da chave estão em uso.
409not_activatedEste aparelho não está ativado (ou foi liberado).
409release_limit_reachedO comprador já liberou 3 aparelhos nos últimos 30 dias.
429rate_limitedMuitas chamadas. Espere os segundos do cabeçalho Retry-After.
500server_errorFalha do nosso lado. Tente de novo mais tarde.

Boas práticas

  • Use no fingerprint algo que não muda quando o comprador reinstala o software. O Likiro guarda só um hash dele.
  • Trate 429 e 500 como falta de internet: deixe o programa abrir se a última validação for recente.
  • Com not_activated na validação, volte para a tela de ativação: o comprador liberou este aparelho.
  • Chaves de outras plataformas não começam com LK-. Se você migrou de outro lugar, use o prefixo para saber qual API chamar.

Python

import hashlib, json, winreg
from urllib.error import HTTPError, URLError
from urllib.request import Request, urlopen

API = "https://www.likiro.com/api/v1/licenses"
PRODUCT_ID = "SEU_PRODUCT_ID"

def fingerprint() -> str:
    # Windows: o MachineGuid não muda ao reinstalar o programa. Mande só o hash.
    with winreg.OpenKey(winreg.HKEY_LOCAL_MACHINE,
                        r"SOFTWARE\Microsoft\Cryptography") as key:
        guid = winreg.QueryValueEx(key, "MachineGuid")[0]
    return hashlib.sha256(f"meu-app:{guid}".encode()).hexdigest()

def call(action: str, license_key: str) -> dict:
    body = json.dumps({
        "license_key": license_key,
        "product_id": PRODUCT_ID,
        "fingerprint": fingerprint(),
    }).encode()
    request = Request(f"{API}/{action}", data=body, method="POST",
                      headers={"Content-Type": "application/json"})
    try:
        with urlopen(request, timeout=10) as response:
            return json.load(response)
    except HTTPError as error:
        try:
            return json.load(error)
        except ValueError:  # resposta sem JSON (proxy, queda)
            return {"error": "server_error"}
    except URLError:
        return {"error": "offline"}

result = call("activate", input("Chave de licença: "))
print("Ativado!" if "data" in result else result["error"])

JavaScript

// Node.js 18+ ou o processo principal do Electron: a API não aceita
// chamadas de páginas web (sem CORS).
const API = "https://www.likiro.com/api/v1/licenses"

async function validate(licenseKey, fingerprint) {
  try {
    const response = await fetch(`${API}/validate`, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        license_key: licenseKey,
        product_id: "SEU_PRODUCT_ID",
        fingerprint,
      }),
    })
    // { data } ou { error }; sem JSON, trate como falha passageira.
    return await response.json().catch(() => ({ error: "server_error" }))
  } catch {
    return { error: "offline" }
  }
}

Dúvidas? Escreva para hi@likiro.com.