نیازمندی‌های فنی

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

  • ارتباط فقط روی HTTPS

    شبکه و امنیتاجباری

    تمام درخواست‌های API و بارگذاری style/tile نقشه باید از طریق https://gochavosh.ir انجام شود.

  • پایهٔ API

    شبکه و امنیتاجباری

    مسیر پایه: /api/v1 — جستجو (/search)، مسیریابی (/route) و ثبت نیازمندی (/website/api-inquiries).

  • توکن JWT برای APIهای محافظت‌شده

    احراز هویتاجباری

    پس از قرارداد، کلید API یا JWT صادر می‌شود؛ در هدر Authorization: Bearer ارسال شود.

  • محدودیت نرخ درخواست

    انطباق و دادهاجباری

    فراخوانی‌ها باید در سقف توافق‌شده بمانند؛ پاسخ 429 نشانهٔ تجاوز از حد مجاز است.

  • استایل نقشه

    نقشه و تایلاجباری

    style-day.json و style-night.json از همان دامنه؛ تایل‌ها از /tiles/iran-farsi/{z}/{x}/{y}.

  • نمایش attribution

    نقشه و تایلاجباری

    کنترل attribution MapLibre باید در UI محصول شما قابل مشاهده بماند.

برای درخواست دسترسی تجاری، فرم پلتفرم API را تکمیل کنید.