aF4!

Comprimento 4

Letras minúsculas
Letras maiúsculas
Números
Símbolos

CryptPass API

Documentação oficial da CryptPass API — um serviço público para geração de senhas fortes e aleatórias.


Visão Geral

A CryptPass API é um serviço RESTful desenvolvido em Python com o framework FastAPI, criado para gerar senhas fortes e aleatórias de forma simples e configurável.

A API permite personalizar a geração de senhas a partir de diferentes critérios definidos pelo cliente, incluindo:

  • Tamanho da senha
  • Uso de letras maiúsculas
  • Uso de letras minúsculas
  • Inclusão de números
  • Inclusão de símbolos e caracteres especiais
  • Diversidade de caracteres utilizados

Quickstart

Base URL: https://cryptpass.onrender.com

Autenticação: não é necessária.

Headers: Content-Type: application/json

Requisição mínima:

curl -X POST https://cryptpass.onrender.com/passwords/generate \
  -H "Content-Type: application/json" \
  -d '{
    "length": 16,
    "lowercase": true,
    "uppercase": true,
    "numbers": true,
    "symbols": true
  }'

Resposta de exemplo:

{
  "password": "A#9kLm2@XpQ7!Rt1",
  "strength": {
    "score": 4,
    "level": "Muito forte",
    "feedback": {
      "warning": "",
      "suggestions": []
    }
  }
}

Base URL

https://cryptpass.onrender.com

Todos os endpoints descritos nesta documentação são relativos a essa URL base.


Autenticação

A CryptPass API é pública e não requer autenticação. Todas as requisições devem ser enviadas no formato JSON.


Endpoints

Gerar senha

Gera uma nova senha de acordo com os critérios informados e retorna uma análise de força da senha gerada.

Request

POST /passwords/generate
PropriedadeValor
MétodoPOST
Endpoint/passwords/generate
Status de sucesso200 OK

Headers

HeaderTipoObrigatórioDescrição
Content-TypestringSimDeve ser application/json.

Body

CampoTipoObrigatórioDescrição
lengthnumberSimTamanho da senha. Mínimo 4 e máximo 128.
lowercasebooleanSimDefine se a senha terá letras minúsculas.
uppercasebooleanSimDefine se a senha terá letras maiúsculas.
numbersbooleanSimDefine se a senha terá números.
symbolsbooleanSimDefine se a senha terá símbolos.
Atenção: pelo menos um tipo de caractere (lowercase, uppercase, numbers ou symbols) deve ser true para que a geração seja realizada com sucesso.

Exemplo de requisição

cURL

curl -X POST https://cryptpass.onrender.com/passwords/generate \
  -H "Content-Type: application/json" \
  -d '{
    "length": 16,
    "lowercase": true,
    "uppercase": true,
    "numbers": true,
    "symbols": true
  }'

JavaScript (fetch)

const response = await fetch("https://cryptpass.onrender.com/passwords/generate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    length: 16,
    lowercase: true,
    uppercase: true,
    numbers: true,
    symbols: true
  })
});

const data = await response.json();

console.log(data.password);

Python (requests)

import requests

response = requests.post(
    "https://cryptpass.onrender.com/passwords/generate",
    json={
        "length": 16,
        "lowercase": True,
        "uppercase": True,
        "numbers": True,
        "symbols": True
    }
)

data = response.json()
print(data["password"])

Exemplo de resposta

{
  "password": "A#9kLm2@XpQ7!Rt1",
  "strength": {
    "score": 4,
    "level": "Muito forte",
    "feedback": {
      "warning": "",
      "suggestions": []
    }
  }
}
CampoTipoDescrição
passwordstringSenha gerada de acordo com os critérios informados.
strengthobjectObjeto contendo a análise de força da senha gerada.