مستندات فنی API پلتفرم GITA
مستندات کامل REST، GraphQL و gRPC پلتفرم GITA OS از فنآوران گیتی افروز با احراز هویت OAuth 2.1 و mTLS، SDKهای رسمی Node.js، Python، .NET، Go و Java و محیط Sandbox آماده.
سه پروتکل، یک پلتفرم
REST / OpenAPI 3.1
بیش از ۱٬۲۰۰ Endpoint با مستندات OpenAPI 3.1، پشتیبانی Pagination مبتنی بر Cursor و فیلتر JSON:API.
GraphQL
Schema یکپارچه برای کوئری چند-منبعی، Subscription بر بستر WebSocket و Persisted Queries برای کاهش هزینه شبکه.
gRPC + Protobuf
برای ارتباطات Service-to-Service با Throughput بالا، Streaming دوطرفه و تأخیر زیر ۵ms در شبکه داخلی.
احراز هویت و امنیت
OAuth 2.1 + PKCE
جریان استاندارد برای اپلیکیشنهای Public و Confidential، با پشتیبانی Refresh Token Rotation و Token Binding.
mTLS سازمانی
احراز هویت دوطرفه با گواهیهای صادره از CA داخلی گیتی افروز یا CA ملی، برای ادغام Backend-to-Backend.
API Keys زماندار
کلیدهای کوتاهعمر با Scope محدود برای اسکریپتها و CI/CD، با چرخش خودکار هر ۹۰ روز.
SSO سازمانی (SAML / OIDC)
ادغام با Active Directory، Keycloak یا IDP اختصاصی شما برای Developer Portal.
SDKهای رسمی
| SDK | دستور نصب | نسخه فعلی |
|---|---|---|
| Node.js / TypeScript | npm i @gita/sdk | v۴٫۲٫۱ |
| Python ۳٫۱۰+ | pip install gita-sdk | v۴٫۲٫۰ |
| .NET ۸ / C# | dotnet add package Gita.Sdk | v۴٫۱٫۳ |
| Go ۱٫۲۲+ | go get github.com/gita/sdk-go | v۴٫۲٫۰ |
| Java ۱۷+ | implementation 'ir.gita:sdk:4.2.0' | v۴٫۲٫۰ |
APIهای اصلی پلتفرم
Identity API
مدیریت کاربر، گروه، نقش، MFA، Session و Audit Log در کل اکوسیستم GITA.
Vault API
ذخیره و استفاده از Secret، گواهی و کلید رمز با HSM ملی و Audit کامل.
Kubernetes API
Provisioning خوشه، Namespace، Deployment، Quota و Network Policy از طریق Declarative API.
BI API
اجرای کوئری روی Semantic Layer، ساخت Dataset و embed داشبورد در اپ خودتان.
ERP API
+۴۰۰ Endpoint برای حسابداری، انبار، فروش، خرید، تولید و منابع انسانی با Webhook رویدادی.
LLM / Vector API
Embedding، Search Hybrid، Completion، Chat و Tool-Use سازگار با استاندارد OpenAI.
Rate Limit بر اساس Plan
| Plan | Sustained RPS | سهمیه ماهانه | Burst |
|---|---|---|---|
| Sandbox رایگان | ۱۰ req/s | ۱۰۰٬۰۰۰ req/ماه | ۲۰ req/s |
| Essential | ۱۰۰ req/s | ۵ میلیون req/ماه | ۲۵۰ req/s |
| Professional | ۱٬۰۰۰ req/s | ۱۰۰ میلیون req/ماه | ۲٬۵۰۰ req/s |
| Enterprise | نامحدود با Capacity Plan | بر اساس قرارداد | مذاکرهای |
آماده شروع توسعه روی GITA هستید؟
با Sandbox رایگان شروع کنید؛ ظرف چند دقیقه به ۱٬۲۰۰ Endpoint دسترسی پیدا میکنید بدون نیاز به قرارداد. تیم Developer Relations ما در کانال Slack شما را همراهی میکند.
ورود به Developer Portal