پرش به مطلب اصلی

🚀 راهنمای شروع سریع با هوشیار۲۴

در این راهنما به صورت مرحله‌به‌مرحله یاد می‌گیرید چگونه در چند دقیقه اولین درخواست خود را به API ارسال کنید و از امکانات آن بهره‌مند شوید.

۱. تعیین آدرس اصلی (Base URL)​

تمامی درخواست‌های شما باید به آدرس پایه زیر ارسال شوند:

https://app.houshyar24.ir/

🛡️ نکته مهم: اطمینان حاصل کنید که تمامی endpoint ها را نسبت به این آدرس بنویسید تا درخواست‌ها به درستی ارسال شوند.

کابران پونیشا​

اگر شما از دسته مشتریانی هستید که از سایت هوش مصنوعی پونیشا وارد می‌شوید، باید برای ارسال درخواست‌های خود از Base URL مخصوص پونیشا استفاده کنید.

https://app-ai.ponisha.ir/

سایر اندپوینت‌ها و مراحل دریافت کلید API و ارسال درخواست‌ها مشابه کاربران عادی است.

۲. ثبت‌نام و شارژ حساب کاربری​

برای استفاده از API، ابتدا باید حساب کاربری خود را ساخته و شارژ نمایید:

  1. وارد پنل کاربری هوشیار۲۴ شوید.
  2. به بخش کیف پول مراجعه کنید.
  3. حساب خود را با مبلغ مورد نظر شارژ نمایید.
  4. پس از شارژ موفق، امکان ایجاد کلید API برای شما فعال خواهد شد.
صفحه کیف پول در پنل کاربری

۳. دریافت کلید API​

کلید API نقش رمز عبور شما برای دسترسی به سرویس‌ها را دارد؛ بنابراین آن را با دقت نگهداری کنید.

مراحل دریافت کلید:

  1. در پنل کاربری، وارد بخش کلیدهای API شوید.
  2. روی گزینه "ایجاد کلید جدید" کلیک کنید.
  3. کلیدی که ساخته شده است را کپی نمایید.
  4. در هر درخواست HTTP خود، این کلید را در هدر Authorization قرار دهید:
Authorization: Token YOUR_API_KEY

🛡️ نکته امنیتی: کلید API شخصی و محرمانه است؛ آن را با دیگران به اشتراک نگذارید و در محیط‌های عمومی ذخیره نکنید.

صفحه کیف پول در پنل کاربری

۴. ارسال اولین درخواست​

اکنون زمان آن رسیده که اولین درخواست خود را تست کنید تا مطمئن شوید همه چیز درست کار می‌کند.

نمونه درخواست با cURL​
curl -X GET "https://app.houshyar24.ir/v1/{endpoint}" \
-H "Authorization: Token {YOUR_API_KEY}"
نمونه درخواست با Python​
import requests

url = "https://app.houshyar24.ir/v1/{endpoint}"
headers = {
    "Authorization": "Token {YOUR_API_KEY}"
}

response = requests.get(url, headers=headers)
print(response.json())

‼️ اگر پاسخ خطا دریافت کردید:

  • مطمئن شوید کلید API صحیح است.
  • حساب شما شارژ شده باشد.
  • آدرس و هدرها دقیق وارد شده باشند.
  • مطمئن شوید که AgentPK صحیح را از قسمت اتصالات برداشته باشید.

🎯 گام بعدی چیست؟​

تبریک می‌گوییم! حالا آماده‌اید تا سایر قابلیت‌های هوشیار۲۴ را بررسی و در پروژه‌های خود ادغام کنید.

برای مشاهده مستندات کامل API، به صفحات زیر مراجعه نمایید: