Vismatix
VISMATIX
App
Docs / Developer API v3 / API Architecture & Base URL
Core Architecture

API Architecture & Base URL المعمارية ورابط الـ API v2

Sub-millisecond REST API v2.0 engine, idempotency caching, and RFC 7807 problem details. محرك REST API v2 فائق السرعة مع دعم التخزين المؤقت لمنع التكرار ومعايير الأخطاء القياسية.

✨ Next-Gen API v3.0 is Available Sub-Millisecond

Ultra-fast standardized JSON envelope, atomic batch posts creation, and dynamic tier rate limiting.

Explore API v3.0 Docs →

Next-Generation REST Architecture

High-throughput content scheduling API built for modern backends, scripts, and autonomous AI agents.

Vismatix REST API v3.0 is engineered for programmatic content scheduling, high concurrency, and autonomous agent interaction. It provides sub-millisecond query execution, zero-conflict idempotency locking, and RFC 7807 structured errors.

صُممت واجهة برمجة تطبيقات Vismatix v2.0 للأتمتة البرمجية والتعامل مع الوكلاء الأذكياء. توفر استجابة فائقة السرعة، وتحكماً كاملاً بالجدولة، ومقاومة لتكرار الطلبات، ورسائل خطأ قياسية.

Base URL /api/v3

High-throughput endpoint root.

Standard REST • JSON UTF-8

RFC 7807 Problem Details.

Idempotency Idempotency-Key

UUID caching on mutating requests.

Dual-Tier Cryptographic Keys

Full Key Guide →

API v3 employs cryptographically salted keys with distinct prefix scoping to prevent accidental privilege escalation across workspace boundaries.

vmtx_u_ Account Master Key

Unrestricted CRUD across all workspaces and account profile mutations (PUT /account/profile).

Header: Authorization: Bearer vmtx_u_...
vmtx_p_ Project Restricted Key

Strictly isolated to a single project. Accessing global account endpoints or other projects returns 403 FORBIDDEN_PROJECT_KEY.

Header: Authorization: Bearer vmtx_p_...

Quick Start: Authenticated Request

Test fetching your scheduled posts via API v3 in your favorite language.

API v3 Modules Directory

v3.0 New
API v3.0 Next-Gen High-Performance Engine واجهة API v3.0 الجيل القادم فائق الأداء

Sub-millisecond unified JSON envelope, sparse fields selection, batch operations, smart peak time-block resolution, and dynamic tier rate limiting. محرك REST فائق السرعة، استجابة موحدة، اختيار الحقول بدقة، عمليات مجمعة، وحل ذكي لفترات الذروة.

Security
Dual-Tier Key Architecture هيكل المفاتيح ثنائي المستويات

Cryptographic isolation: Account Master (vmtx_u_) vs Project Restricted (vmtx_p_) access tiers. العزل التشفيري بين مفاتيح الحساب الشاملة ومفاتيح المشاريع المحدودة لحماية الصلاحيات.

Policy
AI External API Policy (403) سياسة منع الـ AI الخارجي (403)

Strict policy: AI generation via API tokens is blocked (403 AI_API_ACCESS_DISABLED). تنبيه صارم: توليد الـ AI عبر الـ API ممنوع بالكامل ومقتصر على واجهة الويب.

AI Standard
Autonomous AI Agent Protocol بروتوكول الوكلاء المستقلين

Copyable system prompt, RFC 7807 error handling, and zero-conflict automation standard. بروتوكول موحد للوكلاء الأذكياء ومطوري الأدوات مع تعليمات النظام الجاهزة للنسخ.

vmtx_u_
Account & Profile API واجهة الحساب والبيانات

Retrieve account metrics, list user workspaces, and update profile settings (vmtx_u_ only). استعراض بيانات الحساب والمشاريع وتحديث الملف الشخصي عبر مفتاح الحساب الشامل.

Workspaces & Projects API واجهة مساحات العمل والمشاريع

List workspaces or provision new project environments with automated 84-slot calendar grids. إدارة مساحات العمل وإنشاء مشاريع جديدة مع توليد تلقائي لمصفوفة الـ 84 خانة.

Posts & Virality Scoring API واجهة المنشورات ومقياس الانتشار

Create posts with algorithmic virality readiness scoring, smart peak reschedule, and batch creation. صناعة المنشورات وجدولتها مع مقياس الانتشار الخوارزمي والجدولة الذكية لأوقات الذروة.

84-Slot Matrix & Moves API واجهة مصفوفة الـ 84 خانة والجدولة

Query the complete weekly 7-day x 12-slot matrix tree and relocate posts across cells. استعلام مصفوفة الأسبوع بالكامل ونقل المنشورات بين الخانات والفترات الزمنية برمجياً.

Tasks Hub & Backlog API واجهة مركز المهام وسير العمل

List backlog tasks, create actionable items, and 1-click toggle completion status. استعراض المهام البرمجية وإنشاؤها وتبديل حالة إنجازها بنقرة واحدة.

Ideas Scratchpad API واجهة مسودة الأفكار وتحويلها

Capture ideas programmatically and promote them into active scheduled drafts with one call. تسجيل الأفكار برمجياً وتحويلها فورياً إلى مسودات منشورات على التقويم.

Public
System Diagnostics & Health API واجهة فحص النظام والقياس

Public diagnostic probe for database latency, runtime memory, and platform uptime. نقطة نهاية عامة لفحص سرعة استجابة قاعدة البيانات ومراقبة الجاهزية التشغيلية.

Zero-Dependency SDKs حزم الربط الرسمية (بايثون وجافاسكريبت)

Official standard-library clients with built-in HMAC signing, retries, and dual-tier key support. مكتبات برمجية نقية بدون أي اعتمادات خارجية تدعم توقيع HMAC ومفاتيح الصلاحيات.

Events
Webhooks & Event Streaming API واجهة الويب هوك وبث الأحداث

Real-time event subscriptions for post.created, post.published, and task.completed with HMAC validation. اشتراكات فورية في أحداث النشر والمهام مع توقيع أمني واختبار مباشر للتسليم.

vmtx_u_
Audit Logs & Telemetry API سجل التدقيق والنشاط البرمجي

Chronological audit trail of API key invocations, workspace events, actor IPs, and mutations. سجل تدقيق زمني شامل للعمليات المنفذة عبر المفاتيح البرمجية مع عناوين IP ومعرفات العمليات.

Supported Platforms API واجهة منصات التواصل والحدود

List supported social channels, character constraints, media requirements, and posting capabilities. استعراض المنصات المدعومة وحدود الحروف والمرفقات وقدرات النشر لكل شبكة.

Analytics & Cadence Telemetry API واجهة التحليلات ومصفوفة النشاط

Query cadence velocity scores, platform distribution breakdown, and hourly heatmaps. استعلام وتيرة النشر وتوزيع المنصات والخرائط الحرارية لساعات التفاعل.

Content Templates & Blueprints API واجهة قوالب المحتوى الجاهزة

Browse curated high-converting content frameworks and 1-click apply templates to draft posts. استعراض مكتبة القوالب الفيروسية وتطبيقها برمجياً لإنشاء مسودات جاهزة.

Notifications & Alerts API واجهة التنبيهات والإشعارات

List in-app publication alerts, unread counts, mark notifications read, and dismiss. استعراض تنبيهات النشر والعمليات وإدارة الإشعارات المقروءة والعدّاد اللحظي.

GC Wallet & Transactions API واجهة محفظة الرصيد والمعاملات

Query GC credit balances, ledger transactions, redeem gift vouchers, and transfer credits. إدارة رصيد GC وسجل العمليات وشحن قسائم الهدايا وتحويل الرصيد.

Interactive
Live Interactive API Sandbox مجرب الـ API التفاعلي المباشر

Run real requests against /api/v3/* endpoints directly in your browser with real-time latency inspection. تجربة حية ومباشرة لنقاط النهاية من المتصفح مع قياس زمن الاستجابة وعرض الـ JSON.

v3
GEO & AI Citation API واجهة برمجة الـ GEO واقتباس الذكاء الاصطناعي

Programmatic GEO scoring, citable excerpt extraction, and Schema.org markup generation for any content. تحليل برمجي لجاهزية المحتوى للذكاء الاصطناعي واستخراج الاقتباسات وتوليد وسوم Schema تلقائياً.

Was this page helpful?