آموزش گام‌به‌گام اتصال به Victory API با استفاده از Postman

اگر شما یک توسعه‌دهنده هستید، احتمالاً نام Postman را شنیده‌اید. Postman ابزاری قدرتمند برای تست و کار با APIهاست. در این آموزش، نحوه فراخوانی اندپوینت جدید «جدول رده‌بندی» سایت Victory API را با هم بررسی می‌کنیم.

مرحله ۱: نصب و آماده‌سازی

ابتدا نرم‌افزار Postman را دانلود و نصب کنید. پس از اجرا، روی دکمه "+" کلیک کنید تا یک تب جدید باز شود.

مرحله ۲: تنظیمات درخواست (Request)

برای دریافت جدول رده‌بندی، تنظیمات زیر را اعمال کنید:

Method: نوع درخواست را روی GET قرار دهید.

URL: آدرس زیر را کپی و در کادر آدرس وارد کنید: https://api.v1.victoryapi.ir/Standings

مرحله 3: تنظیم API Key در بخش Headers (بسیار مهم)

بدون ارسال کلید اختصاصی، درخواست شما با خطای ۴۰۱ (عدم دسترسی) مواجه می‌شود.

در زیر کادر آدرس، روی تب Headers کلیک کنید.

در ستون Key، عبارت x-vapi-key را تایپ کنید.

در ستون Value، کلیدی که پس از خرید پنل دریافت کرده‌اید را وارد نمایید.

مرحله 4: وارد کردن پارامترها (Query Params)

آدرس مستندات:

https://www.victoryapi.ir/home/Documentation

در تب Params، باید فیلترهای خود را وارد کنید. طبق مستندات ما، فیلد season اجباری است:

در بخش Key عبارت season و در Value عدد 2023 را وارد کنید.

در سطر بعدی، برای فیلتر لیگ، leagueId را برابر با 290 (لیگ برتر ایران) قرار دهید.

مرحله 5: مشاهده نتایج

روی دکمه Send کلیک کنید. اگر همه چیز درست باشد، در قسمت پائین خروجی را به صورت یک فایل JSON شامل نام تیم‌ها، امتیازات، تعداد برد و باخت‌ها مشاهده خواهید کرد.

نکته حرفه‌ای: تولید کد خودکار

یکی از جذابیت‌های Postman این است که پس از تست موفق، می‌توانید روی آیکون </> (Code) در سمت راست کلیک کنید تا کد اتصال به زبان‌های C#, Python, PHP و... را تحویل بگیرید و مستقیماً در پروژه خود کپی کنید.

فراموش نکنید که برای امنیت بیشتر، هرگز کلید اختصاصی (x-vapi-key) خودتون رو در کدهای فرانت‌اند که برای همه قابل مشاهده است قرار ندید. همیشه سعی کنید درخواست‌ها رو از سمت سرور (Back-end) به API ما ارسال کنید.