Documentación de la API

Fondo visual

URL base: https://seecret.it/api

La API REST de Seecret.it permite integrar la creación de seecrets directamente en tus herramientas internas, scripts automatizados, CRM o aplicaciones empresariales. Ha sido diseñada para ser simple, rápida y altamente segura, respetando las mejores prácticas de privacidad y ciberseguridad.

Autenticación

Cada solicitud enviada a la API debe incluir un encabezado Authorization que contenga un token UUID asociado a tu cuenta. Sin este token, ninguna operación será aceptada. La API utiliza un sistema de autenticación seguro basado en los estándares modernos (como Bearer Token). 

Authorization: Bearer TU_TOKEN_UUID

Asegúrate de no exponer nunca tu token en repositorios públicos (GitHub, GitLab, etc.) o en documentación no protegida.

Crear un Seecret (POST)

Para generar un seecret mediante la API, envía una solicitud POST que contenga los siguientes parámetros. Todos los campos deben enviarse usando application/x-www-form-urlencoded.

Parámetro Tipo Obligatorio Descripción
operation string ✅ Debe contener create_seecret para iniciar la creación.
lang string ✅ Idioma de respuesta (fr o en).
seecret string ✅ Contenido del seecret (contraseña, mensaje confidencial…)
expiration_date date (YYYY-MM-DD) ❌ Fecha de expiración personalizada (por defecto: +7 días).
number_view int ❌ Número de visualizaciones permitidas (por defecto: 1).
view_notification int (0 o 1) ❌ Notificación por correo al momento de la lectura (por defecto: 1).
password string ❌ Contraseña opcional requerida antes de abrir.
domain string ❌ Dominio personalizado si utilizas URL branding.

🧪 Ejemplo de solicitud (PHP + cURL)

Aquí tienes un ejemplo completo que muestra cómo crear un seecret mediante una solicitud POST. Puede adaptarse fácilmente para Node.js, Python, Go o cualquier otro lenguaje compatible con HTTP. 

$ch = curl_init("https://seecret.it/api");

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer TU_TOKEN_UUID',
    'Content-Type: application/x-www-form-urlencoded'
]);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'operation' => 'create_seecret',
    'lang' => 'es',
    'seecret' => 'Contraseña Wi-Fi: 12345678',
    'expiration_date' => '2025-06-01',
    'number_view' => 1,
    'view_notification' => 1
]));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

✅ Formato de respuesta

Si la solicitud es exitosa, la API devuelve un objeto JSON con la URL del seecret generado.

{
    "CODE": 200,
    "MESSAGE": "Seecret creado con éxito",
    "data": {
        "RESULT": "success",
        "URL": "https://seecret.it/_XyZAbCd"
    }
}

❌ Ejemplo de error

Si falta un parámetro requerido o el token es inválido, la API devuelve un mensaje de error claro y explícito. 

{
    "CODE": 401,
    "MESSAGE": "Falta el parámetro 'operation'."
}

Seguridad y cumplimiento

La API está construida sobre una arquitectura segura y sigue las recomendaciones de las autoridades especializadas (ANSSI, CNIL). Todos los datos están cifrados y alojados en servidores situados en Francia. Ningún seecret puede consultarse después de su destrucción.

Más información

Se añadirán nuevas operaciones progresivamente (eliminación remota, actualización, estadísticas detalladas, gestión de archivos a través de la API…). Consulta esta página regularmente o sigue las actualizaciones en tu panel de control.

API dedicada al intercambio seguro de contraseñas

La API de Seecret.it es más que una herramienta técnica; es el núcleo del sistema que permite compartir contraseñas de forma segura. Al integrarla en tus aplicaciones, puedes automatizar la generación de enlaces cifrados, temporales y de un solo uso para transmitir información sensible sin exponerla directamente en correos electrónicos, tickets de soporte o mensajes instantáneos.

A diferencia de los métodos tradicionales—muchas veces inseguros y persistentes—la API garantiza que cada contraseña, código o mensaje confidencial se almacene de forma efímera y se elimine automáticamente tras su visualización. Esto reduce drásticamente el riesgo de fugas o exposiciones accidentales.

¿Por qué usar la API para enviar contraseñas?

Desarrolladores, administradores de sistemas y equipos IT manejan frecuentemente accesos sensibles: credenciales VPN, contraseñas de servidores, tokens de API, llaves SSH, accesos SaaS, etc. Con la API de Seecret.it, esta información puede transmitirse de forma segura a un colega, cliente o proveedor usando un enlace de un solo uso en lugar de copiarse en un canal no seguro.

Este método está alineado con las mejores prácticas de seguridad recomendadas por ANSSI y CNIL: nunca enviar contraseñas en texto plano y evitar su conservación innecesaria. La API te ayuda a automatizar estas exigencias dentro de tus flujos internos.

Posibles integraciones para compartir contraseñas

La API se integra fácilmente con herramientas como:

– sistemas de ticketing (Jira, GLPI, Zendesk),
– plataformas DevOps (GitLab, GitHub Actions, Jenkins),
– CRM o ERP internos,
– scripts de automatización (Python, Bash, PHP, Node.js),
– aplicaciones empresariales que requieran accesos temporales confidenciales.

Al automatizar la creación de seecrets, estandarizas un proceso de distribución segura y eliminas malas prácticas habituales en el intercambio de contraseñas.

Una herramienta adaptada a equipos técnicos y empresas

Ya sea que gestiones un equipo IT, un parque informático, un servicio de soporte o atención al cliente, la API te permite establecer un protocolo profesional para el intercambio seguro de contraseñas e información sensible. Elimina los riesgos de enviar credenciales en correos o chats no cifrados y crea una trazabilidad limpia y controlada.

Combinada con las funciones nativas de Seecret.it (expiración automática, contraseña secundaria, restricciones geográficas, eliminación remota…), obtienes una solución completa de gestión de secretos diseñada para entornos exigentes.