پیوندها

یادداشت

سطح حرفه ای

جهت اتصال به endpoint در سیستم API، می بایست از کلید آن استفاده کنید. کلید API خود را دریافت کنید.

لیست

Endpoint در API:

GET

https://zaya.io/api/v1/links

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

curl --location --request GET 'https://zaya.io/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'

پارامتر

نوع

توضیحات

search

اختیاری string

کوئری جستجو.

by

اختیاری string

جستجو بر اساس. مقادیر قابل استفاده: title برای عنوان, alias برای پیوند یکتا, url برای نشانی.

status

اختیاری integer

Filter by status. مقادیر قابل استفاده: 0 برای همه, 1 برای فعال, 2 برای منقضی شده, 3 برای غیرفعال.

space

اختیاری integer

فیلتر بر اساس id.

domain

اختیاری integer

فیلتر بر اساس id دامنه.

sort

اختیاری string

مرتب سازی بر اساس. مقادیر قابل استفاده: desc برای نزولی, asc برای صعودی, max برای بهترین اجرا, min برای کمترین عملکرد.

نمایش

Endpoint در API:

GET

https://zaya.io/api/v1/links/{id}

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

curl --location --request GET 'https://zaya.io/api/v1/links/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'

ساخت

Endpoint در API:

POST

https://zaya.io/api/v1/links

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

curl --location --request POST 'https://zaya.io/api/v1/links' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'

پارامتر

نوع

توضیحات

url

ضروری string

پیوندی که باید کوتاه شود.

alias

اختیاری string

پیوند یکتا دلخواه.

password

اختیاری string

رمز عبور پیوند.

space

اختیاری integer

موضوع پیوندی است که باید در زیر آن ذخیره شود.

domain

اختیاری integer

دامنه ای که می بایست در زیر آن ساخته شود.

disabled

اختیاری integer

بررسی می کند که آیا لینک فعال است یا غیر فعال. مقدار پیشفرض: 0.

public

اختیاری integer

بررسی می کند که آمار لینک عمومی است یا شخصی. مقدار پیشفرض: 0.

description

اختیاری string

شما می توانید توضیح مختصری برای لینک خود وارد کنید. MAX: 127

expiration_url

اختیاری string

پیوندی که بعد از منقضی شدن لینک، کاربران به آن هدایت می شوند.

expiration_date

اختیاری string

تاریخ انقضاء لینک در فرمت YYYY-MM-DD .

expiration_time

اختیاری string

زمان انقضاء لینک در فرمت HH:MM .

expiration_clicks

اختیاری integer

تعداد کلیک هایی که پس از آن باید لینک منقضی شود.

target_type

اختیاری integer

تعیین نوع هدفگیری. مقادیر قابل استفاده: 0 برای انتخاب نشده, 1 برای جغرافیایی, 2 برای انتخاب پلتفرم, 3 برای چرخش لینک.

geo[index][key]

اختیاری string

کد کشور انتخابی می بایست با استاندارد ISO 3166-1 alpha-2 وارد شود.

geo[index][value]

اختیاری string

پیوند کشوری که کاربر به آن هدایت می شود.

platform[index][key]

اختیاری string

نام پلتفرم مورد هدف. مقادیر قابل استفاده: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.

platform[index][value]

اختیاری string

پیوند بسترهای نرم افزاری که کاربر به آن هدایت می شود.

rotation[index][value]

اختیاری string

پیوند چرخشی که کاربر به آن هدایت می شود.

بروزرسانی

Endpoint در API:

PUT PATCH

https://zaya.io/api/v1/links/{id}

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

curl --location --request PUT 'https://zaya.io/api/v1/links/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'url={url}'

پارامتر

نوع

توضیحات

url

اختیاری string

پیوندی که باید کوتاه شود.

alias

اختیاری string

پیوند یکتا دلخواه.

password

اختیاری string

رمز عبور پیوند.

space

اختیاری integer

موضوع پیوندی است که باید در زیر آن ذخیره شود.

domain

اختیاری integer

دامنه ای که می بایست در زیر آن ساخته شود.

disabled

اختیاری integer

بررسی می کند که آیا لینک فعال است یا غیر فعال. مقدار پیشفرض: 0.

public

اختیاری integer

بررسی می کند که آمار لینک عمومی است یا شخصی. مقدار پیشفرض: 0.

description

اختیاری string

شما می توانید توضیح مختصری برای لینک خود وارد کنید. MAX: 127

expiration_url

اختیاری string

پیوندی که بعد از منقضی شدن لینک، کاربران به آن هدایت می شوند.

expiration_date

اختیاری string

تاریخ انقضاء لینک در فرمت YYYY-MM-DD .

expiration_time

اختیاری string

زمان انقضاء لینک در فرمت HH:MM .

expiration_clicks

اختیاری integer

تعداد کلیک هایی که پس از آن باید لینک منقضی شود.

target_type

اختیاری integer

geo[index][key]

اختیاری string

کد کشور انتخابی می بایست با استاندارد ISO 3166-1 alpha-2 وارد شود.

geo[index][value]

اختیاری string

پیوند کشوری که کاربر به آن هدایت می شود.

platform[index][key]

اختیاری string

نام پلتفرم مورد هدف. مقادیر قابل استفاده: iOS, Android, Windows, OS X, Linux, Ubuntu, Chrome OS.

platform[index][value]

اختیاری string

پیوند بسترهای نرم افزاری که کاربر به آن هدایت می شود.

rotation[index][value]

اختیاری string

پیوند چرخشی که کاربر به آن هدایت می شود.

حذف

Endpoint در API:

DELETE

https://zaya.io/api/v1/links/{id}

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

curl --location --request DELETE 'https://zaya.io/api/v1/links/{id}' \
--header 'Authorization: Bearer {api_key}'

پیوندها

آیا از امکانات زایا راضی هستید؟