Vismatix
VISMATIX
App
Docs / Developer API v3 / API v3.0 Next-Gen High-Performance Engine
Next-Gen v3.0

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 فائق السرعة، استجابة موحدة، اختيار الحقول بدقة، عمليات مجمعة، وحل ذكي لفترات الذروة.

API v3.0 Next-Gen Ultra-High Throughput • Sub-Millisecond

Next-Gen API v3.0: Faster, Better, Stronger الجيل القادم من API v3.0: أسرع، أذكى، وأكثر تحكماً

Vismatix API v3.0 is a complete reimagining of the developer engine. Designed for mission-critical automation, AI agents, and enterprise integrations, v3 introduces sub-millisecond JSON envelopes, granular ability tokens, batch operations, sparse field selection, automatic agenda time-block resolution, and dynamic rate limits.

تُمثل واجهة برمجة تطبيقات Vismatix v3.0 الجيل الأكثر تطوراً للمطورين والوكلاء الأذكياء. تقدم استجابة موحدة فائقة السرعة، وتحكماً دقيقاً في الصلاحيات، وعمليات مجمعة للإنشاء، وانتقاء الحقول بدقة، وحلاً ذكياً لفترات الذروة، ومقاومة معززة لتكرار الطلبات.

Base URL /api/v3

High-concurrency root.

Standard Envelope {success, data, meta}

With microsecond execution time.

Dynamic Rate Limit 90 - 300 req/min

Tier-based dynamic throttling.

Replay Lock Idempotency-Key

24h cache replay prevention.

The 5 Pillars of API v3

1
Better & Unified Response Envelope

Every v3 endpoint returns an immutable, standardized JSON contract: success, data, and meta containing response_time_ms, request_id, and optional pagination.

2
Faster: 60-Second Auth Caching

API token lookups and ability evaluations are cached in memory for 60 seconds with instant invalidation upon token updates. Database query overhead on high-frequency loops is reduced by up to 94%.

3
Easier: Auto Time-Block Resolution

You no longer need to manually look up an 84-slot time_block_id. Pass any scheduled_at ISO timestamp, and v3 dynamically resolves or auto-provisions the matching agenda block.

4
More Control: Sparse Fields & Batch Ops

Use ?fields=id,title,status to request only the specific columns your client needs. Create up to 50 scheduled posts in one atomic round-trip via POST /api/v3/posts/batch.

Standardized v3 Envelope Contract

Every response contains response time telemetry, server timestamp, and a traceable request ID.

{
  "success": true,
  "data": {
    "id": 1042,
    "title": "Scaling Social Cadence with Vismatix Matrix",
    "status": "scheduled",
    "scheduled_at": "2026-10-20T14:00:00Z"
  },
  "meta": {
    "timestamp": "2026-10-17T11:42:00+00:00",
    "response_time_ms": 1.24,
    "request_id": "req_8f192b49",
    "version": "v3.0.0"
  }
}

Core API v3 Endpoints

GET /api/v3/posts
Query: fields, status, project_id, limit, page

List posts with sparse field selection and pagination.

curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://nightly.vismatix.online/api/v3/posts?fields=id,title,status,scheduled_at&status=scheduled&limit=25"
POST /api/v3/posts
Auto Time-Block Resolution

Create a scheduled post. If time_block_id is omitted, v3 automatically assigns the corresponding agenda cell for scheduled_at.

curl -X POST "https://nightly.vismatix.online/api/v3/posts" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"title": "Automated Launch Announcement", "description": "Launching v3 API today!", "scheduled_at": "2026-10-22T09:00:00Z", "status": "draft"}'
POST /api/v3/posts/batch
Atomic Bulk (Up to 50 posts)

Create multiple posts atomically within a single database transaction.

curl -X POST "https://nightly.vismatix.online/api/v3/posts/batch" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"posts": [{"title": "Post 1", "scheduled_at": "2026-10-20T10:00:00Z"}, {"title": "Post 2", "scheduled_at": "2026-10-21T10:00:00Z"}]}'
GET /api/v3/matrix
84-Slot Grid & Occupancy Metrics

Retrieve the complete 7-day x 12-slot weekly canvas, occupancy percentage, peak hour slots, and scheduled post density.

curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://nightly.vismatix.online/api/v3/matrix"
POST /api/v3/ai/virality-score
Algorithmic Virality Scoring

Compute 0-100 virality readiness score with breakdown across hook power, curiosity gap, and CTA strength.

curl -X POST "https://nightly.vismatix.online/api/v3/ai/virality-score" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"content": "Stop wasting 15 hours every week planning social media content. Here is how the 84-slot matrix works:"}'
Was this page helpful?