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
| Propriedade | Valor |
| Método | POST |
| Endpoint | /passwords/generate |
| Status de sucesso | 200 OK |
Headers
| Header | Tipo | Obrigatório | Descrição |
| Content-Type | string | Sim | Deve ser application/json. |
Body
| Campo | Tipo | Obrigatório | Descrição |
length | number | Sim | Tamanho da senha. Mínimo 4 e máximo 128. |
lowercase | boolean | Sim | Define se a senha terá letras minúsculas. |
uppercase | boolean | Sim | Define se a senha terá letras maiúsculas. |
numbers | boolean | Sim | Define se a senha terá números. |
symbols | boolean | Sim | Define se a senha terá símbolos. |
Atenção: pelo menos um tipo de caractere (lowercase,uppercase,numbersousymbols) deve sertruepara 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": []
}
}
}
| Campo | Tipo | Descrição |
password | string | Senha gerada de acordo com os critérios informados. |
strength | object | Objeto contendo a análise de força da senha gerada. |