ساخت با هوش مصنوعی
از ایجنت‌های هوش مصنوعی برای کمک در ساخت یکپارچه‌سازی‌های OrcaRail استفاده کنید. اگر در توسعه از LLM استفاده می‌کنید، مجموعه‌ای از ابزارها و بهترین روش‌ها در اختیارتان می‌گذاریم.
مستندات متن ساده
می‌توانید به همه مستندات ما به‌صورت فایل‌های Markdown متن ساده دسترسی داشته باشید. این کار به ابزارها و ایجنت‌های هوش مصنوعی کمک می‌کند محتوای ما را مصرف کنند و به شما اجازه می‌دهد کل یک سند را کپی و در LLM جای‌گذاری کنید. Markdown نسبت به استخراج یا کپی از صفحات HTML و JavaScript ما بهتر است، چون:
- متن ساده توکن‌های قالب‌بندی کمتری دارد
- محتوایی که در نمای پیش‌فرض نمایش داده نمی‌شود (مثلاً در یک تب پنهان است) در نسخه متن ساده نمایش داده می‌شود
- LLMها می‌توانند ساختار سلسله‌مراتبی Markdown را تجزیه و درک کنند
همچنین فایل /llms.txt را میزبانی می‌کنیم که به ابزارها و ایجنت‌های هوش مصنوعی می‌گوید نسخه‌های متن ساده صفحات ما را چطور بگیرند. فایل /llms.txt یک استاندارد نوظهور برای دسترس‌پذیرتر کردن وب‌سایت‌ها و محتوا برای LLMهاست.
سرور MCP
برای ابزارهای کدنویسی مبتنی بر ایجنت که از Model Context Protocol پشتیبانی می‌کنند، پکیج رسمی @orcarail/mcp را نصب کنید. این پکیج ابزارهای payment intent، اشتراک، کاتالوگ، نرخ‌ها و پرداخت را از طریق stdio ارائه می‌دهد (همان ایده سرور MCP استرایپ) تا ایجنت شما بتواند مستقیماً پرداخت بسازد و صورت‌حساب را مدیریت کند.
برای ابزارهای عمومی (rates.*، pay.*) اطلاعات احراز هویت اختیاری است. ابزارهای خصوصی به ORCARAIL_API_KEY و ORCARAIL_API_SECRET نیاز دارند (متغیر محیطی را به فلگ‌های CLI ترجیح دهید).
# Public tools only (no credentials)
npx -y @orcarail/mcp --tools=all
# Claude Code with credentials via env
claude mcp add orcarail \
-e ORCARAIL_API_KEY=ak_live_xxx \
-e ORCARAIL_API_SECRET=sk_live_xxx \
-- npx -y @orcarail/mcp --tools=all
برای Cursor، سرور را به .cursor/mcp.json اضافه کنید؛ برای Codex، به ~/.codex/config.toml. برای راه‌اندازی کامل، مرجع کامل ابزارها و راهنمای امنیتی راهنمای سرور MCP را ببینید.
با ایجنت‌ها از کلید sandbox استفاده کنید
به ایجنت خود کلید API یک سازمان sandbox (ak_test_…) بدهید. آن‌وقت می‌تواند روی شبکه‌های آزمایشی پرداخت بسازد و شبیه‌سازی کند، بدون اینکه هرگز وجه واقعی جابه‌جا شود. فقط برای محیط عملیاتی به کلید live بروید.
مستندات را به ایجنت هوش مصنوعی بدهید
می‌توانید مستندات OrcaRail را مستقیماً در اختیار دستیار کدنویسی هوش مصنوعی خود قرار دهید. چند روش:
کپی یک صفحه مستندات
محتوای هر صفحه مستندات را کپی و در چت LLM جای‌گذاری کنید. برای بهترین نتیجه، منبع Markdown را به‌جای HTML رندرشده کپی کنید.
استفاده از فایل llms.txt
ایجنت هوش مصنوعی را به فایل /llms.txt ما ارجاع دهید. این فایل همه صفحات کلیدی مستندات را با توضیح فهرست می‌کند و پیدا کردن و گرفتن اطلاعات لازم را برای ایجنت آسان می‌کند.
قرار دادن مستندات در پروژه
مستندات مورد نیاز را دانلود کنید و در پوشه پروژه قرار دهید. بسیاری از دستیارهای کدنویسی هوش مصنوعی (مثل Cursor، Windsurf، Claude Code و GitHub Copilot) فایل‌های پروژه را به‌طور خودکار برای زمینه ایندکس می‌کنند.
# Example: download the getting started guide
curl -o orcarail-getting-started.md https://raw.githubusercontent.com/orcarail/orcarail/main/docs/getting-started.md
منابع کلیدی برای ایجنت‌های هوش مصنوعی
هنگام ساخت یکپارچه‌سازی OrcaRail با کمک هوش مصنوعی، این مستندات مفیدترین منابع برای زمینه هستند:
| منبع | توضیح |
|---|---|
| شروع کار | راه‌اندازی حساب، کلیدهای API و اولین پرداخت |
| Payment Intentها | ساخت و مدیریت payment intentها |
| SDK نود | نصب و استفاده از @orcarail/node |
| سرور MCP | اتصال Claude Code، Cursor یا Codex |
| SDK پی‌اچ‌پی | نصب و استفاده از orcarail/orcarail-php |
| وب‌هوک‌ها | دریافت اعلان لحظه‌ای پرداخت |
| اشتراک‌ها | پرداخت دوره‌ای و برداشت خودکار |
| احراز هویت | کلیدهای API و توکن‌های bearer |
| مرجع API | مستندات کامل اندپوینت‌ها |
نکته‌هایی برای توسعه با کمک هوش مصنوعی
-
از شروع کار آغاز کنید — اول صفحه شروع کار را به ایجنت بدهید. ساخت حساب، کلیدهای API و جریان پایه پرداخت را پوشش می‌دهد.
-
مرجع SDK را بدهید — راهنمای SDK نود و مرجع API آن، یا راهنمای SDK پی‌اچ‌پی و مرجع API پی‌اچ‌پی، همه متدهای موجود را با نمونه دارند.
-
برای محیط عملیاتی مستندات وب‌هوک را اضافه کنید — برای یکپارچه‌سازی‌های عملیاتی، همیشه مستندات وب‌هوک‌ها و امضای وب‌هوک را بدهید تا ایجنت پردازش رویداد را درست راه‌اندازی کند.
-
از دمو به‌عنوان قالب استفاده کنید — اپ دمو یک نمونه کامل و کارا است. ایجنت را برای پیاده‌سازی مرجع کامل به مخزن GitHub ارجاع دهید.
-
زنجیره را مشخص کنید — OrcaRail از چند شبکه پشتیبانی می‌کند. به ایجنت بگویید کدام شبکه‌های بلاکچین و توکن‌ها را می‌خواهید بپذیرید تا یکپارچه‌سازی را درست پیکربندی کند.
نکات مهم برای LLMها
:::info برای ایجنت‌های هوش مصنوعی که این صفحه را می‌خوانند
- OrcaRail یک درگاه پرداخت کریپتو است؛ پردازشگر پرداخت فیات سنتی نیست
- همه مبالغ بر حسب استیبل‌کوین (USDC، USDT و غیره) روی شبکه‌های بلاکچین پشتیبانی‌شده هستند
- شیء اصلی بک‌اند Payment Intent است؛ آن را بسازید، تأیید کنید، مشتری را به صفحه پرداخت میزبانی‌شده منتقل کنید و سپس رویدادهای وب‌هوک را پردازش کنید
- احراز هویت برای ارتباط سرور به سرور از کلید + secret API (Basic Auth) و برای درخواست‌های احراز هویت‌شده کاربر از توکن Bearer (JWT) استفاده می‌کند
- SDKهای رسمی
@orcarail/nodeبرای JavaScript/TypeScript وorcarail/orcarail-phpبرای PHP 8.1+ هستند - آدرس پایه API
https://api.orcarail.comاست - همیشه امضای وب‌هوک‌ها را با متدهای بررسی داخلی SDK بررسی کنید
:::