API REST

Documentación de la API

API REST simple y potente: autenticación Bearer, formato JSON, webhooks. Integra el intercambio seguro en tus pipelines DevOps.

Obtener un token Ejemplos de código

Empezar

URL base & formato

La API REST de Seecret.it permite integrar todas las funcionalidades en tus herramientas internas, scripts automáticos, CRM o aplicaciones.

POST https://seecret.it/api
Content-Type: application/x-www-form-urlencoded

Seguridad

Autenticación

Cada petición debe contener un header Authorization con un token Bearer UUID asociado a tu cuenta suscrita.

Authorization: Bearer TU_TOKEN_UUID

Seguridad del token

Nunca expongas tu token en un repositorio público (GitHub, GitLab…). En caso de filtración, regenéralo desde tu dashboard.

Formato de respuestas (JSON)

CODE: 200 = éxito, 400/401/403 = error
MESSAGE: descripción del resultado
data: payload de la respuesta

Referencia

Operaciones disponibles

6 endpoints REST para crear, modificar, consultar y eliminar tus secretos.

create_seecret — Crear un secreto

Parámetro	Tipo	Descripción
`operation`	string	`create_seecret`
`lang`	string	Idioma: `fr`, `en`, `es`, `ru`
`seecret`	string	Contenido del secreto
`expiration_date`	YYYY-MM-DD	Caducidad (defecto: +7 días, máx +60)
`number_view`	int	Vistas permitidas (defecto: 1)
`view_notification`	0 o 1	Notificación email al leer
`password`	string	Contraseña adicional
`recipient_email`	string	Envío auto por email
`country_block[]`	array	Códigos país ISO a bloquear

Ejemplo PHP + cURL

$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_POSTFIELDS, http_build_query([
    'operation'   => 'create_seecret',
    'lang'        => 'es',
    'seecret'     => 'Contraseña SSH: s3cr3t!',
    'number_view' => 1,
]));
$response = json_decode(curl_exec($ch), true);
echo $response['data']['url'];

update_seecret — Modificar un secreto

Modifica un secreto existente. Debe pertenecer a tu cuenta y no estar caducado.

[
    'operation' => 'update_seecret',
    'id'        => 'aB3kZ9',
    'cle'       => 'clave_descifrado',
    'lang'      => 'es',
    'seecret'   => 'Nueva contraseña',
]

get_seecret — Obtener info del secreto

Devuelve metadatos completos: estado, registro, archivos.

{ "CODE": 200, "data": { "id": "aB3kZ9", "status": "pending", "views_count": 0 } }

list_seecrets — Listar tus secretos

Lista paginada con filtros opcionales.

{ "CODE": 200, "data": { "total": 42, "page": 1, "secrets": [ ... ] } }

delete_seecret — Eliminar un secreto

Revoca inmediatamente el secreto. Irreversible.

{ "CODE": 200, "MESSAGE": "Secret deleted successfully" }

get_account — Información de cuenta

{ "CODE": 200, "data": { "email": "[email protected]", "subscription_active": true } }

Conformidad

Seguridad y conformidad

Arquitectura segura, respetando recomendaciones ANSSI y CNIL. Todos los datos cifrados y alojados en Francia.

Cifrado AES-256 zero-knowledge
Alojamiento soberano francés
Conformidad RGPD

Ecosistema

Integraciones posibles

Sistemas de ticketing (Jira, GLPI, Zendesk)
Plataformas DevOps (GitLab CI, GitHub Actions)
CRM o ERP internos
Scripts de automatización (Python, Bash, Node.js)

Ejemplo Python

import requests

resp = requests.post(
    "https://seecret.it/api",
    headers={"Authorization": "Bearer TU_TOKEN_UUID"},
    data={"operation": "create_seecret", "lang": "es", "seecret": "Contraseña VPN"}
)
print(resp.json()["data"]["url"])

¿Listo para integrar la API Seecret.it?

Plan Pro a 2 €/mes — API ilimitada, soporte por email.

Obtener mi token API