XPlanner

Docs

Kullanımı oku

Geçerli abonelik, dönem ve API anahtarının allowlist kapsamına göre kullanım metriklerini döndürür.


GET

/usage

usage:read

Header'lar

Authorization

*
string

API anahtarı. Format: Bearer xpl_live_...

Kullanım metrikleri

accounts

X hesapları

API anahtarının erişim kapsamındaki bağlı X hesabı kullanımını gösterir.

folders

klasörler

Fikir klasörü kullanımını ve plan limitini gösterir.

ideas

fikirler

Fikir havuzu kullanımını gösterir. Sınırsız planda limit null döner.

monthlyPosts

aylık

Geçerli faturalandırma döneminde X'e başarıyla gönderilen pushed gönderi sayısını gösterir.

scheduledPosts

planlı

scheduled ve draft_scheduled durumundaki planlı gönderi kullanımını gösterir.

workspaces

çalışma alanları

API anahtarının erişim kapsamındaki çalışma alanı kullanımını gösterir.

Rate limit özeti

defaultPerMinute

120/dk

Genel okuma istekleri için API anahtarı bazlı dakika limitidir.

mutatingPerMinute

20/dk

POST gibi yazma istekleri için API anahtarı bazlı dakika limitidir.

endpointLimits

object

accounts, folders, ideas, posts, usage ve publish_now için endpoint bazlı limitleri içerir.

Cevaplar

200

Faturalandırma, rate limit ve kullanım özeti.

cURL

curl https://api.xplanner.co/v1/usage \  -H "Authorization: Bearer $XPLANNER_API_KEY"

Cevap

{  "data": {    "billing": {      "accessStatus": "active",      "currentPeriodStart": "2026-05-01T00:00:00.000Z",      "currentPeriodEnd": "2026-06-01T00:00:00.000Z",      "plan": {        "id": "plan_pro",        "key": "pro",        "displayName": "Pro"      }    },    "usage": {      "accounts": { "used": 2, "limit": 5, "remaining": 3 },      "folders": { "used": 6, "limit": 50, "remaining": 44 },      "ideas": { "used": 28, "limit": null, "remaining": null },      "monthlyPosts": { "used": 18, "limit": 300, "remaining": 282 },      "scheduledPosts": { "used": 7, "limit": 50, "remaining": 43 },      "workspaces": { "used": 1, "limit": 3, "remaining": 2 }    },    "rateLimit": {      "defaultPerMinute": 120,      "mutatingPerMinute": 20,      "endpointLimits": {        "accountsReadPerMinute": 60,        "foldersReadPerMinute": 60,        "foldersWritePerMinute": 20,        "ideasReadPerMinute": 60,        "ideasWritePerMinute": 20,        "meReadPerMinute": 60,        "postsReadPerMinute": 60,        "postsWritePerMinute": 10,        "postsWritePerHour": 120,        "postsPublishPerMinute": 3,        "postsPublishPerHour": 30,        "usageReadPerMinute": 20      }    },    "workspaceAccess": "selected",    "workspaceId": "wrk_123",    "workspaceIds": ["wrk_123"]  },  "requestId": "req_123"}