RoomScope

آخر تحديث

صنّاع المحتوى

ملفات صنّاع المحتوى المحفوظة، والتغييرات، وشبكة المتابعة، والتحليلات.

تُصادَق كل عملية بمفتاح API (Authorization: Bearer <key>) وتستخدم الأخطاء الغلاف المشترك الموضّح في الأخطاء. مولَّد من مستند OpenAPI الخاص بواجهة API.

البحث عن صنّاع المحتوى

GET/v1/creators

جزء من اسم المستخدم أو الاسم المعروض، دون تمييز لحالة الأحرف، والأكثر متابعة أولًا. وتؤدي قيمة q الفارغة إلى تصفّح المجموعة المحفوظة.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات الاستعلام

معاملات الاستعلام · GET /v1/creators
NameTypeDescription
qOptional
stringاسم المستخدم (مع @ أو بدونها) أو جزء من الاسم المعروض.
limitOptional
integerالحد الأقصى لعدد النتائج. المدى 1–100.
Default: 20

الطلب

curl "https://api.toktokdata.live/v1/creators" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "query": "linh.live",    "results": [      {        "tiktokUserId": "990000000000000001",        "uniqueId": "linh.live",        "displayName": "Linh Live",        "region": "VN",        "avatarUrl": null,        "followerCount": 123456,        "verified": true      }    ]  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creators-v1",    "window": null  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

جلب ملف صانع محتوى

GET/v1/creators/{uid}

الملف العام المحفوظ وسجل عدّاداته الأخير.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات المسار

معاملات المسار · GET /v1/creators/{uid}
NameTypeDescription
uidRequired
stringاسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي.

الطلب

curl "https://api.toktokdata.live/v1/creators/linh.live" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "creator": {      "tiktokUserId": "990000000000000001",      "uniqueId": "linh.live",      "secUid": null,      "displayName": "Linh Live",      "region": "VN",      "language": null,      "signature": "Daily LIVE from Hanoi",      "avatarUrl": null,      "followerCount": 123456,      "followingCount": 321,      "awemeCount": 3,      "totalFavorited": 9876543,      "favoritingCount": null,      "verified": true,      "customVerify": null,      "enterpriseVerifyReason": null,      "instagramId": null,      "youtubeChannelId": null,      "twitterId": null,      "firstSeenAt": "2026-10-02T10:51:44.935Z",      "lastRefreshedAt": "2026-11-01T10:36:44.935Z",      "history": []    }  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creators-v1",    "window": null  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

تحليل فيديوهات صانع محتوى

GET/v1/creators/{uid}/analysis

تقرير تفاعل محتسَب من الفيديوهات المحفوظة فقط: الإجماليات، والقيم الوسيطة، ووتيرة النشر.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات المسار

معاملات المسار · GET /v1/creators/{uid}/analysis
NameTypeDescription
uidRequired
stringاسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي.

الطلب

curl "https://api.toktokdata.live/v1/creators/linh.live/analysis" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "creator": {      "tiktokUserId": "990000000000000001",      "uniqueId": "linh.live",      "displayName": "Linh Live",      "avatarUrl": null,      "region": "VN",      "verified": true,      "followerCount": 123456,      "followingCount": 321,      "awemeCount": 3,      "totalFavorited": 9876543,      "firstSeenAt": "2026-10-02T10:51:44.935Z",      "lastRefreshedAt": "2026-11-01T10:36:44.935Z"    },    "sample": {      "videosAnalyzed": 3,      "oldestVideoAt": "2026-10-29T10:51:44.935Z",      "newestVideoAt": "2026-10-31T10:51:44.935Z",      "spanDays": 2,      "shareOfCatalog": 1    },    "engagement": {      "totalPlays": 60000,      "totalLikes": 6000,      "totalComments": 600,      "totalShares": 0,      "avgPlays": 20000,      "medianPlays": 20000,      "avgLikes": 2000,      "avgComments": 200,      "avgShares": 0,      "engagementRate": 0.11,      "likeRate": 0.1,      "commentRate": 0.01,      "shareRate": 0,      "viewsPerFollower": 0.162    },    "cadence": {      "postsPerWeek": 7,      "avgDaysBetweenPosts": 1,      "longestGapDays": 1,      "busiestWeekday": 4,      "postsByWeekday": [        0,        0      ]    },    "topByPlays": [      {        "videoId": "7990000000000000003",        "description": "Video 3",        "createTime": "2026-10-29T10:51:44.935Z",        "playCount": 30000,        "diggCount": 3000,        "commentCount": 300,        "shareCount": null,        "engagementRate": 0.11      },      {        "videoId": "7990000000000000002",        "description": "Video 2",        "createTime": "2026-10-30T10:51:44.935Z",        "playCount": 20000,        "diggCount": 2000,        "commentCount": 200,        "shareCount": null,        "engagementRate": 0.11      }    ],    "topByEngagement": [      {        "videoId": "7990000000000000001",        "description": "Video 1",        "createTime": "2026-10-31T10:51:44.935Z",        "playCount": 10000,        "diggCount": 1000,        "commentCount": 100,        "shareCount": null,        "engagementRate": 0.11      },      {        "videoId": "7990000000000000002",        "description": "Video 2",        "createTime": "2026-10-30T10:51:44.935Z",        "playCount": 20000,        "diggCount": 2000,        "commentCount": 200,        "shareCount": null,        "engagementRate": 0.11      }    ],    "audience": null,    "growth": null,    "limits": [      {        "code": "thin-video-sample",        "message": "Only 3 video(s) analysed — too few to describe the account's typical performance."      },      {        "code": "single-observation",        "message": "This account has been observed only once, so no follower growth can be shown yet."      }    ]  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "derived_creator_analysis",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "analysis-v1",    "window": null  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

عرض تغييرات الملف الشخصي

GET/v1/creators/{uid}/changes

تغييرات اسم المستخدم والاسم والنبذة والتوثيق المرصودة بمرور الوقت، من الأحدث إلى الأقدم.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات المسار

معاملات المسار · GET /v1/creators/{uid}/changes
NameTypeDescription
uidRequired
stringاسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي.

معاملات الاستعلام

معاملات الاستعلام · GET /v1/creators/{uid}/changes
NameTypeDescription
limitOptional
integerالحد الأقصى لعدد التغييرات. المدى 1–200.
Default: 50

الطلب

curl "https://api.toktokdata.live/v1/creators/linh.live/changes" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "tiktokUserId": "990000000000000001",    "uniqueId": "linh.live",    "changes": []  },  "provenance": {    "observedAt": "2026-10-02T10:51:44.935Z",    "freshness": "stale",    "source": "public_creator_profile",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "creators-v1",    "window": null  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

عرض متابعي صانع محتوى

GET/v1/creators/{uid}/followers

المتابعون المحفوظون، بالبنية نفسها المستخدمة للحسابات المتابَعة.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات المسار

معاملات المسار · GET /v1/creators/{uid}/followers
NameTypeDescription
uidRequired
stringاسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي.

معاملات الاستعلام

معاملات الاستعلام · GET /v1/creators/{uid}/followers
NameTypeDescription
cursorOptional
stringمؤشر معتم مأخوذ من nextCursor في الصفحة السابقة.
limitOptional
integerعدد الإدخالات في كل صفحة.

الطلب

curl "https://api.toktokdata.live/v1/creators/linh.live/followers" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "tiktokUserId": "990000000000000001",    "uniqueId": "linh.live",    "direction": "following",    "entries": [],    "nextCursor": null,    "hasMore": false,    "totalReported": null,    "storedCount": 0,    "isPrivate": false  },  "provenance": {    "observedAt": "2026-11-01T11:18:49.084Z",    "freshness": "stale",    "source": "public_follow_graph",    "sourceKind": "derived",    "coverageStatus": "not-covered",    "methodologyVersion": "follow-list-v1",    "window": null  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

عرض الحسابات التي يتابعها صانع محتوى

GET/v1/creators/{uid}/following

شبكة المتابعة المحفوظة. تُرجع الحسابات الخاصة isPrivate: true دون أي إدخالات.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات المسار

معاملات المسار · GET /v1/creators/{uid}/following
NameTypeDescription
uidRequired
stringاسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي.

معاملات الاستعلام

معاملات الاستعلام · GET /v1/creators/{uid}/following
NameTypeDescription
cursorOptional
stringمؤشر معتم مأخوذ من nextCursor في الصفحة السابقة.
limitOptional
integerعدد الإدخالات في كل صفحة.

الطلب

curl "https://api.toktokdata.live/v1/creators/linh.live/following" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "tiktokUserId": "990000000000000001",    "uniqueId": "linh.live",    "direction": "following",    "entries": [],    "nextCursor": null,    "hasMore": false,    "totalReported": null,    "storedCount": 0,    "isPrivate": false  },  "provenance": {    "observedAt": "2026-11-01T11:18:49.084Z",    "freshness": "stale",    "source": "public_follow_graph",    "sourceKind": "derived",    "coverageStatus": "not-covered",    "methodologyVersion": "follow-list-v1",    "window": null  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

جلب أبرز الداعمين لصانع محتوى

GET/v1/creators/{uid}/gifters

الداعمون في غرف LIVE الخاصة بصانع المحتوى خلال آخر 7 أو 30 يومًا، مرتّبون حسب الماسات: عدد الهدايا، والجلسات، وآخر هدية، وصانع المحتوى صاحب آخر غرفة أرسلوا فيها هدية. تُقرأ البيانات من الجلسات التي سجّلها RoomScope، لذا تكون التغطية دائمًا partial. يتطلب باقة Pro أو أعلى.

النطاقgifter:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات المسار

معاملات المسار · GET /v1/creators/{uid}/gifters
NameTypeDescription
uidRequired
stringاسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي.

معاملات الاستعلام

معاملات الاستعلام · GET /v1/creators/{uid}/gifters
NameTypeDescription
windowOptional
"7d" | "30d"7d أو 30d.
Default: 7d
limitOptional
integerالحد الأقصى لعدد الصفوف. المدى …–100.
Default: 20

الطلب

curl "https://api.toktokdata.live/v1/creators/linh.live/gifters" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "creatorUid": "7012345678901234567",    "uniqueId": "linh.live",    "window": "7d",    "gifters": [      {        "gifterUserId": "6987001122334455667",        "gifterUniqueId": "minh.fan",        "gifterNickname": "Minh",        "avatarUrl": null,        "diamondTotal": 18450,        "giftCount": 312,        "sessions": 4,        "lastGiftAt": "2026-11-02T15:41:07.512Z",        "lastRoomCreator": "linh.live"      }    ]  },  "provenance": {    "observedAt": "2026-11-02T15:41:07.512Z",    "freshness": "historical",    "source": "platform_observed_gifter_events",    "sourceKind": "derived",    "coverageStatus": "partial",    "methodologyVersion": "gifters-observed-v1",    "window": {      "from": "2026-10-27T04:00:00.000Z",      "to": "2026-11-03T04:00:00.000Z",      "label": "7d"    }  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

جلب رؤى صانع محتوى

GET/v1/creators/{uid}/insights

سجل أسماء المستخدم، والماسات اليومية لآخر 30 يومًا (من الأحدث إلى الأقدم)، ولقطات الدوري اليومية، وغرفة LIVE الخاصة بصانع المحتوى. تكون قيمة liveExact هي true عندما تُقرأ نقاط اليوم عند إعادة ضبط لوحة التصنيف؛ وإلا فإن liveScore هي أعلى نقاط قُرئت في ذلك اليوم. ويَعُدّ observedCoins الماسات التي سجّلها RoomScope في جلسات LIVE لصانع المحتوى. ويظل اسم المستخدم الذي تغيّر قابلًا للاستدلال عليه عبر سجل الأسماء السابقة.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات المسار

معاملات المسار · GET /v1/creators/{uid}/insights
NameTypeDescription
uidRequired
stringاسم مستخدم صانع المحتوى دون @ (linh.live) أو معرّف مستخدم TikTok الرقمي.

الطلب

curl "https://api.toktokdata.live/v1/creators/linh.live/insights" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "creator": {      "uid": "6990000000000000001",      "uniqueId": "linh.live"    },    "aliases": [      {        "uniqueId": "linh.live",        "firstSeenAt": "2026-10-12T09:15:02.118Z",        "lastSeenAt": "2026-11-01T14:02:41.530Z"      },      {        "uniqueId": "linh.official",        "firstSeenAt": "2026-09-30T11:40:19.004Z",        "lastSeenAt": "2026-10-12T08:55:47.912Z"      }    ],    "daily": [      {        "boardDay": "2026-10-31",        "countryCode": "VN",        "tiktokScore": 184250,        "observedCoins": 171932,        "liveScore": 184250,        "liveExact": true,        "leagueClass": "B2"      },      {        "boardDay": "2026-10-30",        "countryCode": "VN",        "tiktokScore": 97410,        "observedCoins": null,        "liveScore": 97410,        "liveExact": false,        "leagueClass": "B2"      }    ],    "league": [      {        "day": "2026-10-31",        "leagueClass": "B2",        "leagueRank": 14,        "leagueCountry": "VN",        "followers": 412880      }    ],    "roomOwner": {      "roomId": "7432000000000000001",      "ownerUid": "6990000000000000001",      "ownerUniqueId": "linh.live",      "claimantUid": null,      "reason": "claim_confirmed",      "checkedAt": "2026-11-01T14:00:03.221Z"    }  },  "provenance": {    "observedAt": "2026-11-01T14:02:41.530Z",    "freshness": "near_realtime",    "source": "creator_analytics",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creator-analytics-v1",    "window": {      "from": "2026-10-02T14:02:41.530Z",      "to": "2026-11-01T14:02:41.530Z",      "label": "30d"    }  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

جلب أفضل وقت لبدء البث المباشر

GET/v1/insights/best-time

الماسات وساعات الداعمين في جلسات LIVE المسجّلة لمنطقة ما خلال آخر windowDays يومًا، حسب يوم الأسبوع (0 = الاثنين) والساعة بتوقيت UTC. يُعاد حسابها يوميًا؛ وتكون cells فارغة ما دام لم يُسجَّل شيء للمنطقة.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات الاستعلام

معاملات الاستعلام · GET /v1/insights/best-time
NameTypeDescription
regionOptional
stringرمز المنطقة وفق ISO 3166-1 alpha-2.
Default: VN

الطلب

curl "https://api.toktokdata.live/v1/insights/best-time" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "region": "VN",    "windowDays": 28,    "computedAt": "2026-11-01T01:00:04.870Z",    "cells": [      {        "weekday": 0,        "hour": 12,        "diamonds": 418230,        "gifterHours": 1874      },      {        "weekday": 0,        "hour": 13,        "diamonds": 652910,        "gifterHours": 2410      },      {        "weekday": 0,        "hour": 14,        "diamonds": 701455,        "gifterHours": 2689      }    ]  },  "provenance": {    "observedAt": "2026-11-01T01:00:04.870Z",    "freshness": "near_realtime",    "source": "creator_analytics",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creator-analytics-v1",    "window": {      "from": "2026-10-04T01:00:04.870Z",      "to": "2026-11-01T01:00:04.870Z",      "label": "28d"    }  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.

جلب حضور LIVE كل ساعة

GET/v1/insights/presence

لكل ساعة، عدد صنّاع المحتوى المصنّفين قيد التتبع في المنطقة الذين كانوا يبثون مباشرة، من الأقدم إلى الأحدث.

النطاقcreator:readوحدات الرصيدقراءة مخزنة مؤقتًا

معاملات الاستعلام

معاملات الاستعلام · GET /v1/insights/presence
NameTypeDescription
regionOptional
stringرمز المنطقة وفق ISO 3166-1 alpha-2.
Default: VN
hoursOptional
integerعدد الساعات إلى الوراء. المدى 1–168.
Default: 48

الطلب

curl "https://api.toktokdata.live/v1/insights/presence" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

الاستجابة

200 OK
{  "data": {    "region": "VN",    "hours": 48,    "points": [      {        "hourStart": "2026-11-01T12:00:00.000Z",        "liveCreators": 214,        "trackedCreators": 1630      },      {        "hourStart": "2026-11-01T13:00:00.000Z",        "liveCreators": 251,        "trackedCreators": 1642      },      {        "hourStart": "2026-11-01T14:00:00.000Z",        "liveCreators": 268,        "trackedCreators": 1655      }    ]  },  "provenance": {    "observedAt": "2026-11-01T14:05:01.402Z",    "freshness": "near_realtime",    "source": "creator_analytics",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "creator-analytics-v1",    "window": {      "from": "2026-10-30T14:05:01.402Z",      "to": "2026-11-01T14:05:01.402Z",      "label": "48h"    }  }}

الأخطاء

  • 400 معامل أو جسم طلب غير صالح؛ ويحدد code المشكلة.
  • 401 مفتاح API مفقود أو غير معروف.
  • 402 لا تكفي محفظة الرصيد في مساحة العمل لتغطية تكلفة الاستدعاء؛ ويوضح resetAt موعد إعادة ضبط الرصيد.
  • 403 المفتاح يفتقر إلى النطاق، أو أن الباقة لا تتضمن الميزة.
  • 429 تم تجاوز معدّل الطلبات؛ التزم بقيمة Retry-After.
هل كانت هذه الصفحة مفيدة؟