Mise à jour de l’API Seecret.it : toutes les nouvelles fonctions disponibles

L’API Seecret.it vient d’être enrichie de nouvelles opérations et paramètres pour offrir aux développeurs un contrôle total sur la création, la gestion et la suppression de secrets chiffrés. Voici un tour complet de tout ce qui est désormais disponible.

Authentification

Toutes les requêtes à l’API nécessitent un token Bearer placé dans le header Authorization. Ce token est disponible dans votre espace compte Seecret.it (abonnement actif requis).

Authorization: Bearer votre-token-uuid

L’API répond en JSON. Chaque réponse contient un champ CODE (code HTTP) et MESSAGE ou data selon l’opération.

Les 6 opérations disponibles

1. Créer un secret — create_seecret

Crée un nouveau lien chiffré à usage unique. C’est l’opération principale de l’API.

Réponse en cas de succès :

{
  "CODE": 200,
  "MESSAGE": "Secret created successfully",
  "data": {
    "id": "abc123",
    "url": "https://seecret.it/_abc123#cleDecryptage",
    "url_short": "https://st.vg/_abc123#cleDecryptage",
    "expires_at": "2026-05-10",
    "split_urls": null
  }
}

Si l’option split_link est activée, le champ split_urls contient le tableau des liens individuels à distribuer à chaque participant.

2. Modifier un secret — update_seecret

Permet de mettre à jour un secret existant tant qu’il n’a pas expiré ou atteint son nombre de vues maximum. La clé de déchiffrement est obligatoire (côté client uniquement).

3. Lire les métadonnées d’un secret — get_seecret

Retourne toutes les informations d’un secret (sans révéler son contenu chiffré) : statut, historique de vues, fichiers joints, restrictions actives…

{
  "operation": "get_seecret",
  "id": "abc123"
}

Réponse :

{
  "CODE": 200,
  "data": {
    "id": "abc123",
    "status": "pending",
    "url": "https://seecret.it/_abc123#cleDecryptage",
    "expiration_date": "2026-05-10",
    "created_at": "2026-04-26 10:00:00",
    "views_count": 1,
    "views_max": 3,
    "views_log": [
      {"date": "2026-04-26 11:30:00", "ip": "91.x.x.x"}
    ],
    "has_password": false,
    "view_notification": true,
    "note": "Credentials serveur prod",
    "domain": null,
    "recipient_email": null,
    "country_block": ["RU"],
    "split_link": 0,
    "split_link_required": 0,
    "files": []
  }
}

Le champ status peut valoir pending (actif), viewed (nombre de vues atteint) ou expired (date dépassée).

4. Lister ses secrets — list_seecrets

Retourne la liste paginée de tous vos secrets avec filtrage par statut et recherche plein texte.

Réponse :

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

5. Supprimer un secret — delete_seecret

Supprime définitivement un secret et ses fichiers joints. Action irréversible.

{
  "operation": "delete_seecret",
  "id": "abc123"
}

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

6. Informations du compte — get_account

Retourne les informations de votre compte, votre quota de stockage, vos domaines personnalisés et des statistiques globales sur vos secrets.

{
  "CODE": 200,
  "data": {
    "email": "[email protected]",
    "first_name": "Jean",
    "last_name": "Dupont",
    "subscription_active": true,
    "subscription_expires_at": "2027-01-01",
    "api_token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "storage_used_bytes": 1048576,
    "storage_quota_bytes": 104857600,
    "domains": [
      {"id": 1, "domain": "secret.monentreprise.com", "url": "https://secret.monentreprise.com"}
    ],
    "stats": {
      "total": 42,
      "pending": 10,
      "viewed": 28,
      "expired": 4
    }
  }
}

Exemple complet en PHP

<?php
$token = 'votre-token-uuid';

$curl = curl_init('https://seecret.it/api');
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query([
        'operation'       => 'create_seecret',
        'seecret'         => 'Mon mot de passe super secret',
        'lang'            => 'fr',
        'expiration_date' => '2026-05-31',
        'number_view'     => 1,
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $token,
        'Content-Type: application/x-www-form-urlencoded',
    ],
]);

$response = json_decode(curl_exec($curl), true);
curl_close($curl);

echo $response['data']['url'];
// https://seecret.it/_abc123#cleDecryptage

Codes de réponse

L’API Seecret.it est réservée aux abonnés actifs. Vous pouvez retrouver votre token dans votre espace compte. Pour toute question, contactez le support depuis votre espace personnel.