المطورون

المصادقة

أرسل مفتاحك السري في ترويسة X-API-Key. يُعرض المفتاح مرة واحدة عند الإنشاء — احفظه بأمان.

curl -X GET "https://tool-verse.online/api/v1/tools/" \
  -H "X-API-Key: tv_live_…" \
  -H "Accept: application/json"

حدود المعدل

• الافتراضي: 60 طلبًا في الدقيقة لكل مفتاح (قابل للتخصيص).
• الحصة الشهرية الافتراضية 10,000 وحدة لكل مفتاح.
• استجابة 429 تعني التراجع وإعادة المحاولة.

نقاط نهاية مفيدة

• GET https://tool-verse.online/api/v1/tools/
• GET https://tool-verse.online/api/v1/tools/{slug}/
• POST https://tool-verse.online/api/v1/t/dynamic/{slug}/run/
• POST https://tool-verse.online/api/v1/jobs/
• GET https://tool-verse.online/api/v1/jobs/{id}/

OpenAPI

Download the machine-readable schema for code generation and Enterprise integrations.

TypeScript SDK

Use the workspace package @toolverse/api-client for marketplace and mobile endpoints. Regenerate the stub with manage.py generate_sdk.

npm install @toolverse/api-client

import { ToolVerseApiClient } from "@toolverse/api-client";

const client = new ToolVerseApiClient({
  apiKey: process.env.TOOLVERSE_API_KEY!,
  clientPlatform: "web",
});

const tools = await client.listTools({ compact: true });

Usage billing stubs

Monthly invoice drafts are generated from API usage aggregates. They stay draft until you reconcile billing externally.

• GET /marketplace/invoices/ — draft ApiInvoiceStub rows from usage
• GET /marketplace/analytics/ — daily usage and per-key breakdown

Enterprise

Developer organizations, usage analytics, and invoice stubs for billed API access. Create an org from your account API or contact sales for Enterprise tier.

• GET /marketplace/analytics/ — daily usage time-series
• GET/POST /marketplace/orgs/ — manage developer organizations