ورود به پنل توسعهدهندگان
برای مدیریت کلیدها و خرید اعتبار، وارد حساب شخصی خود شوید.
ساخت حساب شخصی
نام کاربری و رمز را نگه دارید؛ بازیابی خودکار رمز فعلاً وجود ندارد. حساب جدید با اعتبار صفر ساخته میشود.
API جستوجوی وب
مدیریت کلیدها، تنظیمات و مصرف API از داخل پنل.
- تعرفه
- ۱۰٬۰۰۰ تومان / ۱۰۰۰ درخواست
- هزینهٔ هر درخواست موفق
- ۱۰ تومان
- تعداد نتایج هر درخواست
- ۱ تا ۱۰ نتیجه
بستهٔ ۱۰۰۰ درخواست با قیمت ۱۰٬۰۰۰ تومان برای حساب شخصی ارائه میشود. پرداخت آنلاین از طریق زیبال است. حساب مشترک بررسی اینماد فقط آزمایشی است.
مشاهدهٔ مستندات APIاولین جستوجو با API
از پنل یک کلید بسازید و آن را در متغیر محیطی GAPWEB_API_KEY قرار دهید. درخواستها را از سرور برنامهٔ خود ارسال کنید.
curl https://gapweb.ir/v1/search \
-H "Authorization: Bearer $GAPWEB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"تهران","num_results":5}'پارامترها
| نام | توضیح |
|---|---|
query | عبارت جستوجو، بین ۱ تا ۳۰۰ کاراکتر؛ الزامی. |
num_results | عدد ۱ تا ۱۰؛ اختیاری. در نبود آن، تنظیم حساب اعمال میشود. |
نمونهٔ ساختار پاسخ
این نمونهٔ آموزشی است؛ نتایج هر درخواست از ایندکس واقعی جستوجو دریافت میشوند.
{
"request_id": "1",
"results": [
{"title": "Example", "url": "https://example.com", "snippet": "…"}
],
"usage": {"cost_toman": 10, "remaining_credit_toman": 990}
}محاسبهٔ مصرف و خطاها
- پاسخ موفق ۲۰۰، حتی با نتایج خالی، یک درخواست محسوب میشود و ۱۰ تومان از اعتبار کم میکند.
- خطای ورودی، کلید نامعتبر، شلوغی سرویس و خطای جستوجو هزینهای ندارند.
400: ورودی نامعتبر؛401: کلید نامعتبر یا لغوشده؛402: اعتبار تمام شده است.429: محدودیت درخواست؛ مطابق Retry-After دوباره تلاش کنید.502/503: سرویس موقتاً در دسترس نیست.- کلیدهای این حساب از یک اعتبار مشترک استفاده میکنند. لغو کلید فوری است؛ درخواستهای پذیرفتهشدهٔ قبلی میتوانند کامل شوند.