گزارش‌ها

یادداشت‌ها
Expert level
کلید API باید به عنوان توکن Bearer در سرصفحه Authorization درخواست ارسال شود. کلید API خود را دریافت کنید.
فهرست

نقطه پایانی API:

GET 
https://seofar.com/api/v1/reports

مثال درخواست: 

curl --location --request GET 'https://seofar.com/api/v1/reports' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
پارامتر
نوع
توضیحات
search
اختیاری string
عبارت جستجو.
search_by
اختیاری string
جستجو بر اساس. مقادیر ممکن عبارتند از: url برای آدرس. پیش‌فرض: url.
project
اختیاری string
نام پروژه.
result
اختیاری string
The report result. مقادیر ممکن عبارتند از: good برای خوب, decent برای مناسب, bad برای بد.
sort_by
اختیاری string
مرتب‌سازی بر اساس. مقادیر ممکن عبارتند از: id برای تاریخ ایجاد, generated_at برای تاریخ ایجاد, url برای آدرس, result برای نتیجه. پیش‌فرض: id.
sort
اختیاری string
مرتب‌سازی. مقادیر ممکن عبارتند از: desc برای نزولی, asc برای صعودی. پیش‌فرض: desc.
per_page
اختیاری integer
نتایج در هر صفحه. مقادیر ممکن عبارتند از: 10, 25, 50, 100. پیش‌فرض: 10.
نمایش

نقطه پایانی API:

GET 
https://seofar.com/api/v1/reports/{id}

مثال درخواست: 

curl --location --request GET 'https://seofar.com/api/v1/reports/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
ذخیره

نقطه پایانی API:

POST 
https://seofar.com/api/v1/reports

مثال درخواست: 

curl --location --request POST 'https://seofar.com/api/v1/reports' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'
پارامتر
نوع
توضیحات
url
الزامی string
The webpage's URL.
privacy
اختیاری integer
Report page privacy. مقادیر ممکن عبارتند از: 0 برای عمومی, 1 برای خصوصی, 2 برای رمز عبور. پیش‌فرض: 0.
password
اختیاری string
The password for the report page. Only works with privacy set to 2.
به‌روزرسانی

نقطه پایانی API:

PUT PATCH 
https://seofar.com/api/v1/reports/{id}

مثال درخواست: 

curl --location --request PUT 'https://seofar.com/api/v1/reports/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}'
پارامتر
نوع
توضیحات
privacy
اختیاری integer
Report page privacy. مقادیر ممکن عبارتند از: 0 برای عمومی, 1 برای خصوصی, 2 برای رمز عبور.
password
اختیاری string
The password for the report page. Only works with privacy set to 2.
results
اختیاری integer
Update the report results. مقادیر ممکن عبارتند از: 0 برای خیر, 1 برای بله. پیش‌فرض: 0.
حذف

نقطه پایانی API:

DELETE 
https://seofar.com/api/v1/reports/{id}

مثال درخواست: 

curl --location --request DELETE 'https://seofar.com/api/v1/reports/{id}' \
--header 'Authorization: Bearer {api_key}'