آدرس درخواست :
https://zaya.io/api/v1/links
مثال ها :
# CURL Example:
curl --location --request GET 'https://zaya.io/api/v1/links' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
# PHP Example:
$params = [];
$url = "https://zaya.io/api/v1/links";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer {api_key}'
]);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);
پاسخ ها :
200 { "data":[ {...} ], "links":{ "first":"string", "last":"string", "prev":"string", "next":"string" }, "meta":{ "current_page":0, "from":0, "last_page":0, "links":[ {pagination} ], "path":"string", "per_page":0, "to":0, "total":0 } }
403412 { "message":"string", "status":INTEGER }
پارامتر ها :
searchbyمشخص کنید براساس کدام مقدار می خواهید جستجو کنید:
نکته: درصورتی که این پارامتر را ارسال نکنید جستجو برای تمام فیلد ها انجام میشود.
title برای عنوان
alias برای پیوند کوتاه
url برای نشانی
statusشما می توانید پیوند ها را براساس وضعیتشان فیلتر کنید.
0 یا عدم ارسال برای همه
1 برای فعال
2 برای بررسی نشده
3 برای غیرفعال
4 برای مسدود شده
5 برای منقضی شده
spaceشما می توانید پیوند های خود را براساس موضوع فیلتر کنید.
نکته: درصورتی که این پارامتر را ارسال نکنید تمامی پیوند ها نمایش داده می شوند.
نکته: دقت داشته باشید که مقدار این پارامتر باید دقیقا ID یک موضوع مشخص باشد.
شما می توانید از قسمت موضوعات لیست و ID آنها را مشاهده کنید.
domainشما می توانید پیوند های خود را براساس دامنه نیز فیلتر کنید.
نکته: درصورتی که این پارامتر را ارسال نکنید تمامی پیوند ها نمایش داده می شوند.
نکته: دقت داشته باشید که مقدار این پارامتر باید دقیقا ID یک دامنه مشخص باشد.
شما می توانید از قسمت دامنه ها لیست و ID آنها را مشاهده کنید.
favoritesبا ارسال 1 به عنوان مقدار این پارامتر می توانید لینک های مورد علاقه خود را دریافت کنید.
sortشما می توانید نتایج را بصورت دلخواه مرتب کنید.
desc یا عدم ارسال برای جدیدترین ها
asc برای قدیمی ترین ها
max برای بیشترین کلیک
min برای کمترین کلیک
آدرس درخواست :
https://zaya.io/api/v1/links
مثال ها :
# CURL Example:
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}'
# PHP Example:
$url = "https://zaya.io/api/v1/links";
$params = ['url' => '{url}'];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer {api_key}'
]);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);
پاسخ ها :
200 { "data":[ {...} ], "status":200 }
403412 { "message":"string", "status":INTEGER }
422 { "message":{ "param":[ "string" ] }, "status":INTEGER }
پارامتر ها :
urlaliaspasswordspaceشما می توانید موضوع دلخواه خود را برای پیوند کوتاه تنظیم کنید.
نکته: دقت داشته باشید که مقدار این پارامتر باید دقیقا ID یک موضوع مشخص باشد.
شما می توانید از قسمت موضوعات لیست و ID آنها را مشاهده کنید.
domainشما می توانید دامنه دلخواه خود را برای پیوند کوتاه تنظیم کنید.
نکته: دقت داشته باشید که مقدار این پارامتر باید دقیقا ID یک دامنه مشخص باشد.
شما می توانید از قسمت دامنه ها لیست و ID آنها را مشاهده کنید.
disabledبرای غیرفعال کردن پیوند کوتاه مقدار این پارامتر را 1 قرار دهید.
نکته: بصورت پیشفرض پیوند فعال می باشد.
publicبرای عمومی کردن آمار پیوند مقدار این پارامتر را 1 قرار دهید.
نکته: بصورت پیشفرض آمار پیوند خصوصی می باشد
descriptionMAX: 127 charactersexpiration_urlexpiration_dateتاریخ انقضاء لینک در فرمت YYYY-MM-DD .
نکته: تاریخ را به میلادی وارد کنید.
expiration_timeHH:MM .expiration_clickstarget_typeبا استفاده از این پارامتر می توانید نوع هدف گیری را مشخص کنید.
نکته: عدم ارسال یا مقدار 0 به معنی غیرفعال بودن هدف گیری می باشد.
1 برای جغرافیایی
2 برای انتخاب پلتفرم
3 برای چرخش لینک
geo[index][key],
geo[index][value]برای هدف گیری جغرافیایی، کد کشور را باید با کلید key ارسال کنید.
و آدرس URL مورد نظر را باید با کلید value ارسال کنید.
نکته: کد کشور انتخابی می بایست با استاندارد ISO 3166-1 alpha-2 وارد شود.
نکته: پارامتر ارسالی باید یک آرایه باشد و مقدایر باید بصورتی که اشاره شد جایگذاری شوند.
platform[index][key],
platform[index][value]برای هدف گیری پلتفرم، نام پلتفرم مورد نظر را باید با کلید key ارسال کنید.
و آدرس URL مورد نظر را باید با کلید value ارسال کنید.
نکته: مقادیر قابل استفاده: Ubuntu, Linux, OS X, Windows, Android, iOS, Chrome OS
نکته: پارامتر ارسالی باید یک آرایه باشد و مقدایر باید بصورتی که اشاره شد جایگذاری شوند.
rotation[index][value]با استفاده از این قابلیت شما می توانید برای هرکلیک به صورت چرخشی کاربر را به پیوند متفاوتی منتقل کنید.
نکته: آدرس URL مورد نظر را باید با کلید value ارسال کنید.
نکته: پارامتر ارسالی باید یک آرایه باشد و مقدایر باید بصورتی که اشاره شد جایگذاری شوند.
آدرس درخواست :
https://zaya.io/api/v1/links/{id}
مثال ها :
# CURL Example:
curl --location --request GET 'https://zaya.io/api/v1/links/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
# PHP Example:
$url = "https://zaya.io/api/v1/links/{id}";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer {api_key}'
]);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);
پاسخ ها :
200 { "data":[ {...} ], "status":200 }
403412404 { "message":"string", "status":INTEGER }
آدرس درخواست :
https://zaya.io/api/v1/links/{id}
مثال ها :
# CURL Example:
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}'
# PHP Example:
$params = ['url' => '{url}'];
$url = https://zaya.io/api/v1/links/{id};
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer {api_key}'
]);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);
پاسخ ها :
200 { "data":[ {...} ], "status":200 }
403412404 { "message":"string", "status":INTEGER }
422 { "message":{ "param":[ "string" ] }, "status":INTEGER }
پارامتر ها :
urlaliaspasswordspaceشما می توانید موضوع دلخواه خود را برای پیوند کوتاه تنظیم کنید.
نکته: دقت داشته باشید که مقدار این پارامتر باید دقیقا ID یک موضوع مشخص باشد.
شما می توانید از قسمت موضوعات لیست و ID آنها را مشاهده کنید.
domainشما می توانید دامنه دلخواه خود را برای پیوند کوتاه تنظیم کنید.
نکته: دقت داشته باشید که مقدار این پارامتر باید دقیقا ID یک دامنه مشخص باشد.
شما می توانید از قسمت دامنه ها لیست و ID آنها را مشاهده کنید.
disabledبرای غیرفعال کردن پیوند کوتاه مقدار این پارامتر را 1 قرار دهید.
نکته: بصورت پیشفرض پیوند فعال می باشد.
publicبرای عمومی کردن آمار پیوند مقدار این پارامتر را 1 قرار دهید.
نکته: بصورت پیشفرض آمار پیوند خصوصی می باشد
descriptionMAX: 127 charactersexpiration_urlexpiration_dateتاریخ انقضاء لینک در فرمت YYYY-MM-DD .
نکته: تاریخ را به میلادی وارد کنید.
expiration_timeHH:MM .expiration_clickstarget_typeبا استفاده از این پارامتر می توانید نوع هدف گیری را مشخص کنید.
نکته: عدم ارسال یا مقدار 0 به معنی غیرفعال بودن هدف گیری می باشد.
1 برای جغرافیایی
2 برای انتخاب پلتفرم
3 برای چرخش لینک
geo[index][key],
geo[index][value]برای هدف گیری جغرافیایی، کد کشور را باید با کلید key ارسال کنید.
و آدرس URL مورد نظر را باید با کلید value ارسال کنید.
نکته: کد کشور انتخابی می بایست با استاندارد ISO 3166-1 alpha-2 وارد شود.
نکته: پارامتر ارسالی باید یک آرایه باشد و مقدایر باید بصورتی که اشاره شد جایگذاری شوند.
platform[index][key],
platform[index][value]برای هدف گیری پلتفرم، نام پلتفرم مورد نظر را باید با کلید key ارسال کنید.
و آدرس URL مورد نظر را باید با کلید value ارسال کنید.
نکته: مقادیر قابل استفاده: Ubuntu, Linux, OS X, Windows, Android, iOS, Chrome OS
نکته: پارامتر ارسالی باید یک آرایه باشد و مقدایر باید بصورتی که اشاره شد جایگذاری شوند.
rotation[index][value]با استفاده از این قابلیت شما می توانید برای هرکلیک به صورت چرخشی کاربر را به پیوند متفاوتی منتقل کنید.
نکته: آدرس URL مورد نظر را باید با کلید value ارسال کنید.
نکته: پارامتر ارسالی باید یک آرایه باشد و مقدایر باید بصورتی که اشاره شد جایگذاری شوند.
آدرس درخواست :
https://zaya.io/api/v1/links/{id}
مثال درخواست:
# CURL Example:
curl --location --request DELETE 'https://zaya.io/api/v1/links/{id}' \
--header 'Authorization: Bearer {api_key}'
# PHP Example:
$url = https://zaya.io/api/v1/links/{id};
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer {api_key}'
]);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$result = json_decode($result, true);
پاسخ ها :
200
{
"id": int,
"object": "link",
"deleted": boolean,
"status": 200
}
403412404 { "message":"string", "status":INTEGER }