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
activatecom a chave e um identificador do aparelho. Repetir no mesmo aparelho não gasta outra vaga. - Depois, chame
validatede 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. Comfingerprint, 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>" }.
| HTTP | Código | Quando |
|---|---|---|
| 400 | bad_request | Corpo inválido, campo faltando ou chamada sem Content-Type JSON. |
| 404 | not_found | A ação do endereço não existe. |
| 404 | invalid_license | A chave não existe ou é de outro produto. |
| 403 | license_disabled | Você desativou a chave no painel. |
| 403 | license_revoked | A compra foi reembolsada ou contestada. |
| 403 | membership_inactive | Chave de resgate de membro, e o membro saiu do nível. |
| 409 | activation_limit_reached | Todos os aparelhos da chave estão em uso. |
| 409 | not_activated | Este aparelho não está ativado (ou foi liberado). |
| 409 | release_limit_reached | O comprador já liberou 3 aparelhos nos últimos 30 dias. |
| 429 | rate_limited | Muitas chamadas. Espere os segundos do cabeçalho Retry-After. |
| 500 | server_error | Falha do nosso lado. Tente de novo mais tarde. |
Boas práticas
- Use no
fingerprintalgo que não muda quando o comprador reinstala o software. O Likiro guarda só um hash dele. - Trate
429e500como falta de internet: deixe o programa abrir se a última validação for recente. - Com
not_activatedna 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.

