هيكل البيانات
لا يقوم Hexbon بتشفير بياناتك فحسب، بل يقوم بتنظيمها أيضًا. تعرف على تنسيق JSON المطلوب وتحقق من بياناتك لفتح التجربة التفاعلية الكاملة.
الفصول
لماذا تعتبر بنية البيانات مهمة
Hexbon هو أكثر من مجرد أداة تشفير؛ إنه نظام تخزين بيانات منظم. يتم تنظيم بياناتك في تنسيق هرمي يتيح ميزات قوية مثل إعادة الترتيب بالسحب والإفلات، والبطاقات التفاعلية، والسجلات القابلة للتوسيع، والأقسام المنظمة.
الهيكل مقابل التشفير
يمكننا دائمًا فك تشفير بياناتك إذا قدمت مفتاح التشفير الصحيح. ومع ذلك، إذا كانت بياناتك لا تتبع إرشادات الهيكل الخاصة بنا، فسنعرضها في الوضع الخام (raw mode) - سترى البيانات، ولكن بدون ميزات واجهة المستخدم التفاعلية مثل البطاقات والسجلات والأقسام والسحب والإفلات وما إلى ذلك.
يوضح هذا التوثيق هيكل JSON الدقيق الذي يتوقعه Hexbon. يضمن اتباع هذا الهيكل توافق بياناتك تمامًا مع الميزات التفاعلية للوحة التحكم الخاصة بنا.
نظرة عامة على الهيكل
تتبع بيانات Hexbon تسلسلاً هرميًا صارمًا. فهم هذا التسلسل الهرمي هو المفتاح لتنظيم بياناتك بشكل صحيح.
تسلسل البيانات الهرمي
{ "cards": [...] }{
"title": "Personal",
"records": [...],
"updated_at": 1763938832
}{
"title": "Gmail",
"data": [...]
}{
"name": "Login",
"values": [...]
}{
"value": "secret123",
"type": "secret"
}| الخاصية | مطلوب | ينطبق على |
|---|---|---|
| cards | نعم | الكائن الجذر |
| title | نعم | البطاقة، السجل |
| records | نعم | البطاقة |
| data | نعم | السجل (مصفوفة من الأقسام) |
| name | نعم | القسم |
| values | نعم | القسم |
| value | نعم | القيمة |
| type | نعم | القيمة (secret, note, totp, link, email) |
| id | لا | القيمة (للفرز) |
| updated_at | لا | البطاقة (الطابع الزمني) |
البطاقات
البطاقات هي الحاويات ذات المستوى الأعلى في لوحة التحكم الخاصة بك. تظهر كل بطاقة كمربع قابل للنقر يمكن توسيعه للكشف عن سجلاته. يمكن إعادة ترتيب البطاقات عبر السحب والإفلات.
{
"title": "string", // Required: Card name displayed on tile
"records": [], // Required: Array of Record objects
"updated_at": 1763938832 // Optional: Unix timestamp of last update
}| الخاصية | النوع | مطلوب | الوصف |
|---|---|---|---|
| title | string | نعم | الاسم المعروض على مربع البطاقة |
| records | array | نعم | مصفوفة من كائنات السجل (يمكن أن تكون فارغة) |
| updated_at | integer | لا | طابع زمني Unix لعرض "آخر تحديث" |
{
"title": "Work Credentials",
"records": [
// Record objects go here...
],
"updated_at": 1763938832
}السجلات
السجلات هي مدخلات داخل البطاقة. تظهر في الشريط الجانبي الأيسر عند فتح البطاقة ويمكن اختيارها لعرض أقسامها. فكر في السجلات كعناصر أو مدخلات فردية (مثل "حساب Gmail"، "VPN الشركة"، "بيانات اعتماد قاعدة البيانات").
{
"title": "string", // Required: Record name displayed in sidebar
"data": [] // Required: Array of Section objects
}| الخاصية | النوع | مطلوب | الوصف |
|---|---|---|---|
| title | string | نعم | الاسم المعروض في قائمة السجلات |
| data | array | نعم | مصفوفة من كائنات القسم (يمكن أن تكون فارغة) |
ملاحظة:
تحتوي الخاصية data على "أقسام"، وليس بيانات خام. هذه التسمية لأسباب تاريخية. كل عنصر في مصفوفة data هو كائن قسم.
{
"title": "Gmail Account",
"data": [
{
"name": "Login Details",
"values": [
// Value objects go here...
]
}
]
}الأقسام
تقوم الأقسام بتجميع القيم ذات الصلة داخل السجل. وهي توفر مستوى تنظيميًا يساعد في تصنيف أنواع مختلفة من المعلومات (مثل "تفاصيل تسجيل الدخول"، "خيارات الاسترداد"، "مفاتيح API"). كل قسم له اسم ويحتوي على قيم متعددة.
{
"name": "string", // Required: Section heading/label
"values": [] // Required: Array of Value objects
}| الخاصية | النوع | مطلوب | الوصف |
|---|---|---|---|
| name | string | نعم | عنوان القسم المعروض فوق القيم |
| values | array | نعم | مصفوفة من كائنات القيمة التي تحتوي على بياناتك |
{
"name": "Login Details",
"values": [
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
},
{
"value": "supersecretpassword123",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
]
}القيم
القيم هي مدخلات البيانات الفعلية - كلمات المرور والملاحظات ورموز TOTP التي تقوم بتخزينها. كل قيمة لها نوع يحدد كيفية عرضها وكيفية التفاعل معها في واجهة المستخدم.
{
"value": "string", // Required: The actual content
"type": "secret" | "note" | "totp" | "link" | "email" | "username", // Required
"id": "string" // Optional: Unique identifier for sorting
}| الخاصية | النوع | مطلوب | الوصف |
|---|---|---|---|
| value | string | نعم | المحتوى الفعلي (كلمة المرور، نص الملاحظة، سر TOTP) |
| type | string | نعم | واحد من: "secret" أو "note" أو "totp" أو "link" أو "email" أو "username" |
| id | string | لا | معرف فريد يستخدم للفرز والمرجع |
أنواع القيم
| النوع | العرض | حالة الاستخدام |
|---|---|---|
| "secret" | مخفي افتراضيًا (•••••)، انقر للكشف | كلمات المرور، مفاتيح API، البيانات الحساسة |
| "note" | نص عادي مرئي دائمًا | أسماء المستخدمين، رسائل البريد الإلكتروني، عناوين URL، المعلومات غير الحساسة |
| "totp" | يولد رموزًا مكونة من 6 أرقام في الوقت الفعلي | أسرار 2FA (مشفرة بـ Base32) |
| "link" | ارتباط تشعبي قابل للنقر | عناوين URL، عناوين المواقع الإلكترونية |
| "email" | عنوان بريد إلكتروني مع رابط mailto | عناوين البريد الإلكتروني |
| "username" | نص عادي مرئي دائمًا مع أيقونة مستخدم | أسماء المستخدمين، معرفات الحسابات |
// Secret value (hidden by default)
{
"value": "MySecurePassword123!",
"type": "secret",
"id": "value_1763938251026_fvjeq1vg9"
}
// Note value (always visible)
{
"value": "user@example.com",
"type": "note",
"id": "value_1763938238781_3jh5i3r20"
}
// TOTP value (generates 2FA codes)
{
"value": "JBSWY3DPEHPK3PXP",
"type": "totp",
"id": "value_1763938267595_kaecs9y31"
}
// Username value (visible text with user icon)
{
"value": "john_doe_123",
"type": "username",
"id": "value_1763938289412_xm2kp7v91"
}مثال كامل
إليك هيكل بيانات كامل وصحيح يوضح التسلسل الهرمي بأكمله مع بطاقات وسجلات وأقسام متعددة وأنواع قيم مختلفة.
{
"cards": [
{
"title": "Personal Accounts",
"records": [
{
"title": "Gmail",
"data": [
{
"name": "Login Details",
"values": [
{
"value": "myemail@gmail.com",
"type": "note"
},
{
"value": "SuperSecretPassword123",
"type": "secret"
}
]
},
{
"name": "2FA",
"values": [
{
"value": "JBSWY3DPEHPK3PXP",
"type": "totp"
}
]
}
]
},
{
"title": "GitHub",
"data": [
{
"name": "Account",
"values": [
{
"value": "myusername",
"type": "note"
},
{
"value": "gh_token_abc123xyz",
"type": "secret"
}
]
}
]
}
],
"updated_at": 1763938832
},
{
"title": "Work",
"records": [
{
"title": "VPN Access",
"data": [
{
"name": "Credentials",
"values": [
{
"value": "vpn.company.com",
"type": "note"
},
{
"value": "john.doe",
"type": "note"
},
{
"value": "VpnP@ssw0rd!",
"type": "secret"
}
]
}
]
}
],
"updated_at": 1763856530
}
]
}الوضع الخام (Raw Mode)
إذا كانت بياناتك التي تم فك تشفيرها لا تتبع الهيكل المتوقع، فسيقوم Hexbon بعرضها على أي حال، ولكن في الوضع الخام. هذا يعني أنك سترى بياناتك كـ JSON بسيط بدون الميزات التفاعلية التي توفرها البيانات المنظمة.
| الميزة | الوضع المنظم | الوضع الخام |
|---|---|---|
| مربعات بطاقات تفاعلية | ||
| إعادة الترتيب بالسحب والإفلات | ||
| إخفاء الأسرار مع مفتاح كشف | ||
| توليد رموز TOTP في الوقت الفعلي | ||
| التحرير في المكان والحفظ التلقائي | ||
| أزرار النسخ إلى الحافظة |
بياناتك آمنة دائمًا
يؤثر الوضع الخام فقط على العرض، وليس الأمان. يتم تشفير بياناتك دائمًا بتشفير AES-256-GCM بغض النظر عن الهيكل. ببساطة لن تحصل على ميزات واجهة المستخدم التفاعلية إذا لم يتطابق الهيكل.
تحقق من هيكل بياناتك
استخدم أداة التحقق التفاعلية الخاصة بنا للتحقق من هيكل بياناتك في الوقت الفعلي.
جرب أداة التحقق