{"id":1162,"date":"2026-04-26T06:28:39","date_gmt":"2026-04-26T04:28:39","guid":{"rendered":"https:\/\/seecret.it\/blog\/?p=1162"},"modified":"2026-04-26T07:24:10","modified_gmt":"2026-04-26T05:24:10","slug":"mise-a-jour-de-lapi-seecret-it-toutes-les-nouvelles-fonctions-disponibles","status":"publish","type":"post","link":"https:\/\/seecret.it\/blog\/mise-a-jour-de-lapi-seecret-it-toutes-les-nouvelles-fonctions-disponibles\/","title":{"rendered":"Mise \u00e0 jour de l’API Seecret.it : toutes les nouvelles fonctions disponibles"},"content":{"rendered":"

L’API Seecret.it vient d’\u00eatre enrichie de nouvelles op\u00e9rations et param\u00e8tres pour offrir aux d\u00e9veloppeurs un contr\u00f4le total sur la cr\u00e9ation, la gestion et la suppression de secrets chiffr\u00e9s. Voici un tour complet de tout ce qui est d\u00e9sormais disponible.<\/p>\n

\n

Authentification<\/h2>\n

Toutes les requ\u00eates \u00e0 l’API n\u00e9cessitent un token Bearer plac\u00e9 dans le header Authorization<\/code>. Ce token est disponible dans votre espace compte Seecret.it (abonnement actif requis).<\/p>\n

Authorization: Bearer votre-token-uuid<\/code><\/pre>\n
L’API r\u00e9pond en JSON. Chaque r\u00e9ponse contient un champ CODE<\/code> (code HTTP) et MESSAGE<\/code> ou data<\/code> selon l’op\u00e9ration.<\/p>\n
\n
Les 6 op\u00e9rations disponibles<\/h2>\n
1. Cr\u00e9er un secret \u2014 create_seecret<\/code><\/h3>\n
Cr\u00e9e un nouveau lien chiffr\u00e9 \u00e0 usage unique. C’est l’op\u00e9ration principale de l’API.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nObligatoire<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
operation<\/code><\/td>\n\u2705<\/td>\nValeur : create_seecret<\/code><\/td>\n<\/tr>\n
seecret<\/code><\/td>\n\u2705<\/td>\nLe contenu du secret \u00e0 chiffrer<\/td>\n<\/tr>\n
lang<\/code><\/td>\n\u2705<\/td>\nLangue de l’interface (fr<\/code>, en<\/code>, es<\/code>, ru<\/code>)<\/td>\n<\/tr>\n
expiration_date<\/code><\/td>\n\u274c<\/td>\nDate d’expiration au format YYYY-MM-DD<\/code><\/td>\n<\/tr>\n
number_view<\/code><\/td>\n\u274c<\/td>\nNombre maximum de consultations autoris\u00e9es<\/td>\n<\/tr>\n
password<\/code><\/td>\n\u274c<\/td>\nMot de passe requis pour acc\u00e9der au secret<\/td>\n<\/tr>\n
view_notification<\/code><\/td>\n\u274c<\/td>\nRecevoir une notification email \u00e0 chaque vue<\/td>\n<\/tr>\n
recipient_email<\/code><\/td>\n\u274c<\/td>\nEmail du destinataire (re\u00e7oit le lien par email)<\/td>\n<\/tr>\n
country_block<\/code><\/td>\n\u274c<\/td>\nTableau de codes pays bloqu\u00e9s (ex: [\"RU\",\"CN\"]<\/code>)<\/td>\n<\/tr>\n
domain<\/code><\/td>\n\u274c<\/td>\nDomaine personnalis\u00e9 pour le lien g\u00e9n\u00e9r\u00e9<\/td>\n<\/tr>\n
note<\/code><\/td>\n\u274c<\/td>\nNote interne (non chiffr\u00e9e, visible uniquement par vous)<\/td>\n<\/tr>\n
split_link<\/code><\/td>\n\u274c<\/td>\nNombre de liens Shamir pour le partage multi-parties<\/td>\n<\/tr>\n
split_link_required<\/code><\/td>\n\u274c<\/td>\nNombre de liens requis pour r\u00e9v\u00e9ler le secret<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
R\u00e9ponse en cas de succ\u00e8s :<\/strong><\/p>\n
{\r\n  \"CODE\": 200,\r\n  \"MESSAGE\": \"Secret created successfully\",\r\n  \"data\": {\r\n    \"id\": \"abc123\",\r\n    \"url\": \"https:\/\/seecret.it\/_abc123#cleDecryptage\",\r\n    \"url_short\": \"https:\/\/st.vg\/_abc123#cleDecryptage\",\r\n    \"expires_at\": \"2026-05-10\",\r\n    \"split_urls\": null\r\n  }\r\n}<\/code><\/pre>\n
Si l’option split_link<\/code> est activ\u00e9e, le champ split_urls<\/code> contient le tableau des liens individuels \u00e0 distribuer \u00e0 chaque participant.<\/p>\n
\n
2. Modifier un secret \u2014 update_seecret<\/code><\/h3>\n
Permet de mettre \u00e0 jour un secret existant tant qu’il n’a pas expir\u00e9 ou atteint son nombre de vues maximum. La cl\u00e9 de d\u00e9chiffrement est obligatoire (c\u00f4t\u00e9 client uniquement).<\/p>\n\n\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nObligatoire<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
id<\/code><\/td>\n\u2705<\/td>\nIdentifiant du secret \u00e0 modifier<\/td>\n<\/tr>\n
cle<\/code><\/td>\n\u2705<\/td>\nCl\u00e9 de d\u00e9chiffrement (fragment #<\/code> de l’URL originale)<\/td>\n<\/tr>\n
seecret<\/code><\/td>\n\u2705<\/td>\nNouveau contenu du secret<\/td>\n<\/tr>\n
delete_password<\/code><\/td>\n\u274c<\/td>\nPasser \u00e0 1<\/code> pour supprimer le mot de passe existant<\/td>\n<\/tr>\n
Tous les autres param\u00e8tres de create_seecret<\/code> sont \u00e9galement disponibles<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n
3. Lire les m\u00e9tadonn\u00e9es d’un secret \u2014 get_seecret<\/code><\/h3>\n
Retourne toutes les informations d’un secret (sans r\u00e9v\u00e9ler son contenu chiffr\u00e9) : statut, historique de vues, fichiers joints, restrictions actives\u2026<\/p>\n
{\r\n  \"operation\": \"get_seecret\",\r\n  \"id\": \"abc123\"\r\n}<\/code><\/pre>\n
R\u00e9ponse :<\/strong><\/p>\n
{\r\n  \"CODE\": 200,\r\n  \"data\": {\r\n    \"id\": \"abc123\",\r\n    \"status\": \"pending\",\r\n    \"url\": \"https:\/\/seecret.it\/_abc123#cleDecryptage\",\r\n    \"expiration_date\": \"2026-05-10\",\r\n    \"created_at\": \"2026-04-26 10:00:00\",\r\n    \"views_count\": 1,\r\n    \"views_max\": 3,\r\n    \"views_log\": [\r\n      {\"date\": \"2026-04-26 11:30:00\", \"ip\": \"91.x.x.x\"}\r\n    ],\r\n    \"has_password\": false,\r\n    \"view_notification\": true,\r\n    \"note\": \"Credentials serveur prod\",\r\n    \"domain\": null,\r\n    \"recipient_email\": null,\r\n    \"country_block\": [\"RU\"],\r\n    \"split_link\": 0,\r\n    \"split_link_required\": 0,\r\n    \"files\": []\r\n  }\r\n}<\/code><\/pre>\n
Le champ status<\/code> peut valoir pending<\/code> (actif), viewed<\/code> (nombre de vues atteint) ou expired<\/code> (date d\u00e9pass\u00e9e).<\/p>\n
\n
4. Lister ses secrets \u2014 list_seecrets<\/code><\/h3>\n
Retourne la liste pagin\u00e9e de tous vos secrets avec filtrage par statut et recherche plein texte.<\/p>\n\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nValeur par d\u00e9faut<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
page<\/code><\/td>\n1<\/td>\nNum\u00e9ro de page<\/td>\n<\/tr>\n
limit<\/code><\/td>\n20 (max 100)<\/td>\nNombre de r\u00e9sultats par page<\/td>\n<\/tr>\n
search<\/code><\/td>\n\u2014<\/td>\nRecherche dans l’ID, la note ou les noms de fichiers<\/td>\n<\/tr>\n
status<\/code><\/td>\ntous<\/td>\npending<\/code> \/ viewed<\/code> \/ expired<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
R\u00e9ponse :<\/strong><\/p>\n
{\r\n  \"CODE\": 200,\r\n  \"data\": {\r\n    \"total\": 42,\r\n    \"page\": 1,\r\n    \"limit\": 20,\r\n    \"pages\": 3,\r\n    \"secrets\": [ ... ]\r\n  }\r\n}<\/code><\/pre>\n
\n
5. Supprimer un secret \u2014 delete_seecret<\/code><\/h3>\n
Supprime d\u00e9finitivement un secret et ses fichiers joints. Action irr\u00e9versible.<\/p>\n
{\r\n  \"operation\": \"delete_seecret\",\r\n  \"id\": \"abc123\"\r\n}<\/code><\/pre>\n
{\"CODE\": 200, \"MESSAGE\": \"Secret deleted successfully\"}<\/code><\/pre>\n
\n
6. Informations du compte \u2014 get_account<\/code><\/h3>\n
Retourne les informations de votre compte, votre quota de stockage, vos domaines personnalis\u00e9s et des statistiques globales sur vos secrets.<\/p>\n
{\r\n  \"CODE\": 200,\r\n  \"data\": {\r\n    \"email\": \"vous@exemple.com\",\r\n    \"first_name\": \"Jean\",\r\n    \"last_name\": \"Dupont\",\r\n    \"subscription_active\": true,\r\n    \"subscription_expires_at\": \"2027-01-01\",\r\n    \"api_token\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\",\r\n    \"storage_used_bytes\": 1048576,\r\n    \"storage_quota_bytes\": 104857600,\r\n    \"domains\": [\r\n      {\"id\": 1, \"domain\": \"secret.monentreprise.com\", \"url\": \"https:\/\/secret.monentreprise.com\"}\r\n    ],\r\n    \"stats\": {\r\n      \"total\": 42,\r\n      \"pending\": 10,\r\n      \"viewed\": 28,\r\n      \"expired\": 4\r\n    }\r\n  }\r\n}<\/code><\/pre>\n
\n
Exemple complet en PHP<\/h2>\n
<?php\r\n$token = 'votre-token-uuid';\r\n\r\n$curl = curl_init('https:\/\/seecret.it\/api');\r\ncurl_setopt_array($curl, [\r\n    CURLOPT_RETURNTRANSFER => true,\r\n    CURLOPT_POST           => true,\r\n    CURLOPT_POSTFIELDS     => http_build_query([\r\n        'operation'       => 'create_seecret',\r\n        'seecret'         => 'Mon mot de passe super secret',\r\n        'lang'            => 'fr',\r\n        'expiration_date' => '2026-05-31',\r\n        'number_view'     => 1,\r\n    ]),\r\n    CURLOPT_HTTPHEADER => [\r\n        'Authorization: Bearer ' . $token,\r\n        'Content-Type: application\/x-www-form-urlencoded',\r\n    ],\r\n]);\r\n\r\n$response = json_decode(curl_exec($curl), true);\r\ncurl_close($curl);\r\n\r\necho $response['data']['url'];\r\n\/\/ https:\/\/seecret.it\/_abc123#cleDecryptage<\/code><\/pre>\n
\n
Codes de r\u00e9ponse<\/h2>\n\n\n\n\n\n\n\n\n
Code<\/th>\nSignification<\/th>\n<\/tr>\n<\/thead>\n
200<\/code><\/td>\nSucc\u00e8s<\/td>\n<\/tr>\n
400<\/code><\/td>\nParam\u00e8tre manquant ou invalide<\/td>\n<\/tr>\n
401<\/code><\/td>\nToken manquant, invalide ou abonnement inactif<\/td>\n<\/tr>\n
403<\/code><\/td>\nSecret introuvable ou acc\u00e8s refus\u00e9<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n
L’API Seecret.it est r\u00e9serv\u00e9e aux abonn\u00e9s actifs.<\/strong> Vous pouvez retrouver votre token dans votre espace compte. Pour toute question, contactez le support depuis votre espace personnel.<\/p>\n","protected":false},"excerpt":{"rendered":"
L’API Seecret.it vient d’\u00eatre enrichie de nouvelles op\u00e9rations et param\u00e8tres pour offrir aux d\u00e9veloppeurs un contr\u00f4le total sur la cr\u00e9ation, la gestion et la suppression de secrets chiffr\u00e9s. Voici un tour complet de tout ce qui est d\u00e9sormais disponible. Authentification Toutes les requ\u00eates \u00e0 l’API n\u00e9cessitent un token Bearer plac\u00e9 dans le header Authorization. Ce…<\/p>\n","protected":false},"author":1,"featured_media":1166,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"none","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","footnotes":""},"categories":[16],"tags":[248,252,253,254,251,192,255,17,250,249,51,198],"class_list":["post-1162","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-seecret-it","tag-api","tag-chiffrement","tag-developpeur","tag-documentation","tag-json","tag-lien-ephemere","tag-mise-a-jour","tag-partage-securise","tag-php","tag-rest-api","tag-seecret-it","tag-zero-knowledge"," c-blog-1-item  nt-post-class"],"_links":{"self":[{"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/posts\/1162","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/comments?post=1162"}],"version-history":[{"count":2,"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/posts\/1162\/revisions"}],"predecessor-version":[{"id":1167,"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/posts\/1162\/revisions\/1167"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/media\/1166"}],"wp:attachment":[{"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/media?parent=1162"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/categories?post=1162"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/seecret.it\/blog\/wp-json\/wp\/v2\/tags?post=1162"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}