REST API

Документация API

Простой и мощный REST API: Bearer-авторизация, JSON, webhook. Интегрируйте безопасный обмен в DevOps-пайплайны.

Получить токен Примеры кода

Начало работы

Базовый URL & формат

REST API Seecret.it позволяет интегрировать все функции в ваши инструменты, скрипты, CRM или бизнес-приложения.

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

Безопасность

Аутентификация

Каждый запрос должен содержать заголовок Authorization с Bearer UUID-токеном, связанным с вашей подпиской.

Authorization: Bearer ВАШ_TOKEN_UUID

Безопасность токена

Никогда не публикуйте ваш токен в открытом репозитории. В случае утечки сразу перегенерируйте его из dashboard.

Формат ответов (JSON)

CODE: 200 = успех, 400/401/403 = ошибка
MESSAGE: описание результата
data: данные ответа

Справочник

Доступные операции

6 REST-эндпоинтов для создания, изменения, просмотра и удаления ваших секретов.

create_seecret — Создать секрет

Параметр	Тип	Описание
`operation`	string	`create_seecret`
`lang`	string	Язык: `fr`, `en`, `es`, `ru`
`seecret`	string	Содержимое секрета
`expiration_date`	YYYY-MM-DD	Срок действия (по умолч.: +7 дней)
`number_view`	int	Число просмотров (по умолч.: 1)
`view_notification`	0 или 1	Email-уведомление при чтении
`password`	string	Дополнительный пароль
`recipient_email`	string	Автоотправка по email
`country_block[]`	array	ISO-коды стран для блокировки

Пример PHP + cURL

$ch = curl_init("https://seecret.it/api");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ВАШ_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'        => 'ru',
    'seecret'     => 'SSH пароль: s3cr3t!',
    'number_view' => 1,
]));
$response = json_decode(curl_exec($ch), true);
echo $response['data']['url'];

update_seecret — Изменить секрет

Изменяет существующий секрет. Должен принадлежать вашему аккаунту и не быть просроченным.

[
    'operation' => 'update_seecret',
    'id'        => 'aB3kZ9',
    'cle'       => 'ключ_дешифровки',
    'seecret'   => 'Новый пароль',
]

get_seecret — Получить инфо

Возвращает полные метаданные: статус, журнал просмотров, файлы.

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

list_seecrets — Список секретов

Постраничный список с опциональными фильтрами.

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

delete_seecret — Удалить

Немедленно отзывает секрет. Необратимо.

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

get_account — Информация об аккаунте

{ "CODE": 200, "data": { "email": "вы@пример.ru", "subscription_active": true } }

Соответствие

Безопасность и соответствие

Безопасная архитектура, соблюдение рекомендаций ANSSI и CNIL. Все данные зашифрованы и хранятся во Франции.

Шифрование AES-256 zero-knowledge
Суверенный французский хостинг
Соответствие GDPR
Полный audit trail через webhook

Экосистема

Возможные интеграции

Системы тикетов (Jira, GLPI, Zendesk)
DevOps-платформы (GitLab CI, GitHub Actions, Jenkins)
Внутренние CRM и ERP
Скрипты автоматизации (Python, Bash, Node.js)

Пример Python

import requests

resp = requests.post(
    "https://seecret.it/api",
    headers={"Authorization": "Bearer ВАШ_TOKEN_UUID"},
    data={"operation": "create_seecret", "lang": "ru", "seecret": "VPN пароль"}
)
print(resp.json()["data"]["url"])

Готовы интегрировать API Seecret.it?

Pro-тариф 2 €/мес — безлимитный API, email-поддержка, подписанные webhook.

Получить мой API-токен