الروابط

استرد كل

النقطة النهائية

GET https://qrcloud.online/api/links/

مثال

curl --request GET \
--url 'https://qrcloud.online/api/links/' \
--header 'Authorization: Bearer {api_key}' \

المعلمات	تفاصيل	الوصف
search	اختياري سلسلة	سلسلة البحث.
search_by	اختياري سلسلة	في أي مجال تبحث؟ القيم المسموح بها هي: `url`, `location_url`, `name`.
is_enabled	اختياري بوليان
domain_id	اختياري عدد صحيح
datetime_field	اختياري سلسلة	القيم المسموح بها: `datetime`, `last_datetime`
datetime_start	اختياري سلسلة	تصفية النتائج ابتداءً من هذا التاريخ. الصيغة `Y-m-d H:i:s`.
datetime_end	اختياري سلسلة	تصفية النتائج حتى هذا التاريخ. تنسيق `Y-m-d H:i:s`.
order_by	اختياري سلسلة	أي حقل لترتيب النتائج حسبه. القيم المسموح بها هي: `link_id`, `datetime`, `last_datetime`, `url`, `location_url`, `pageviews`, `name`.
order_type	اختياري سلسلة	ترتيب النتائج. القيم المسموح بها هي: `ASC` للترتيب التصاعدي، و`DESC` للترتيب التنازلي.
page	اختياري عدد صحيح	رقم الصفحة التي ترغب في الحصول على النتائج منها. القيمة الافتراضية هي `1`.
results_per_page	اختياري عدد صحيح	كم عدد النتائج التي تريد لكل صفحة. القيم المسموح بها هي: `10`, `25`, `50`, `100`, `250`, `500`, `1000`. القيمة الافتراضية هي `25`.

مثال الاستجابة

{
    "data": [
        {
            "id": 1,
            "project_id": null,
            "domain_id": 0,
            "type": "link",
            "url": "example",
            "location_url": "https://example.com/",
            "settings": {
                "password": null,
                "sensitive_content": false
            },
            "pageviews": 10,
            "order": 0,
            "start_date": null,
            "end_date": null,
            "datetime": "2026-04-29 21:07:59",
        }
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://qrcloud.online/api/links?page=1",
        "last": "https://qrcloud.online/api/links?page=1",
        "next": null,
        "prev": null,
        "self": "https://qrcloud.online/api/links?page=1"
    }
}

Retrieve one

النقطة النهائية

GET https://qrcloud.online/api/links/{link_id}

مثال

curl --request GET \
--url 'https://qrcloud.online/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \

مثال الاستجابة

{
    "data": {
        "id": 1,
        "project_id": null,
        "domain_id": 0,
        "type": "link",
        "url": "example",
        "location_url": "https://example.com/",
        "settings": {
            "password": null,
            "sensitive_content": false
        },
        "pageviews": 10,
        "order": 0,
        "start_date": null,
        "end_date": null,
        "datetime": "2026-04-29 21:07:59",
    }
}

المعلمات	تفاصيل	الوصف
location_url	مطلوب سلسلة	عنوان URL الوجهة.متوفر عندما: is_bulk = 0
location_urls	مطلوب سلسلة	عنوان URL الوجهة.متوفر عندما: is_bulk = 1
url	اختياري سلسلة	الاسم المستعار لعنوان الرابط المولد. اتركه فارغًا ليتم إنشاء أحد بشكل عشوائي.متوفر عندما: is_bulk = 0
is_bulk	اختياري بوليان
domain_id	اختياري عدد صحيح	-
project_id	اختياري عدد صحيح	-
pixels_ids	اختياري مصفوفة عدد صحيح	-
schedule	اختياري بوليان	-
start_date	اختياري سلسلة	متوفر عندما: schedule = true
end_date	اختياري سلسلة	متوفر عندما: schedule = true
pageviews_limit	اختياري عدد صحيح	-
expiration_url	اختياري سلسلة	-
password	اختياري سلسلة	-
is_se_visible	اختياري بوليان	-
forward_query_parameters_is_enabled	اختياري بوليان	-
utm_source	اختياري سلسلة	-
utm_medium	اختياري سلسلة	-
utm_campaign	اختياري سلسلة	-
sensitive_content	اختياري بوليان	-
http_status_code	اختياري عدد صحيح	القيم المسموح بها: `301`, `302`, `307`, `308`
app_linking_is_enabled	اختياري بوليان	-
cloaking_is_enabled	اختياري بوليان	-
cloaking_title	اختياري سلسلة	-
cloaking_meta_description	اختياري سلسلة	-
cloaking_custom_js	اختياري سلسلة	-
cloaking_favicon	اختياري ملف	-
cloaking_opengraph	اختياري ملف	-
targeting_type	اختياري سلسلة	`continent_code`, `country_code`, `city_name`, `device_type`, `browser_language`, `rotation`, `os_name`, `browser_name`
targeting_continent_code_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = continent_code
targeting_continent_code_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = continent_code
targeting_country_code_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = country_code
targeting_country_code_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = country_code
targeting_city_name_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = city_name
targeting_city_name_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = city_name
targeting_device_type_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = device_type
targeting_device_type_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = device_type
targeting_browser_language_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_language
targeting_browser_language_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_language
targeting_rotation_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = rotation
targeting_rotation_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = rotation
targeting_os_name_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = os_name
targeting_os_name_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = os_name
targeting_browser_name_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_name
targeting_browser_name_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_name

curl --request POST \
--url 'https://qrcloud.online/api/links' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'url=example' \
--form 'location_url=https://qrcloud.online/' \

مثال الاستجابة

{
    "data": {
        "id": 1
    }
}

تحديث

النقطة النهائية

POST https://qrcloud.online/api/links/{link_id}

المعلمات	تفاصيل	الوصف
location_url	اختياري سلسلة	عنوان URL الوجهة.
url	اختياري سلسلة	الاسم المستعار لعنوان الرابط المولد. اتركه فارغًا ليتم إنشاء أحد بشكل عشوائي.
domain_id	اختياري عدد صحيح	-
project_id	اختياري عدد صحيح	-
pixels_ids	اختياري مصفوفة عدد صحيح	-
schedule	اختياري بوليان	-
start_date	اختياري سلسلة	متوفر عندما: schedule = true
end_date	اختياري سلسلة	متوفر عندما: schedule = true
pageviews_limit	اختياري عدد صحيح	-
expiration_url	اختياري سلسلة	-
password	اختياري سلسلة	-
is_se_visible	اختياري بوليان	-
forward_query_parameters_is_enabled	اختياري بوليان	-
utm_source	اختياري سلسلة	-
utm_medium	اختياري سلسلة	-
utm_campaign	اختياري سلسلة	-
sensitive_content	اختياري بوليان	-
http_status_code	اختياري عدد صحيح	القيم المسموح بها: `301`, `302`, `307`, `308`
app_linking_is_enabled	اختياري بوليان	-
cloaking_is_enabled	اختياري بوليان	-
cloaking_title	اختياري سلسلة	-
cloaking_meta_description	اختياري سلسلة	-
cloaking_custom_js	اختياري سلسلة	-
cloaking_favicon	اختياري ملف	-
cloaking_opengraph	اختياري ملف	-
targeting_type	اختياري سلسلة	`continent_code`, `country_code`, `city_name`, `device_type`, `browser_language`, `rotation`, `os_name`, `browser_name`
targeting_continent_code_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = continent_code
targeting_continent_code_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = continent_code
targeting_country_code_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = country_code
targeting_country_code_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = country_code
targeting_city_name_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = city_name
targeting_city_name_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = city_name
targeting_device_type_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = device_type
targeting_device_type_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = device_type
targeting_browser_language_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_language
targeting_browser_language_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_language
targeting_rotation_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = rotation
targeting_rotation_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = rotation
targeting_os_name_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = os_name
targeting_os_name_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = os_name
targeting_browser_name_key[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_name
targeting_browser_name_value[index]	اختياري سلسلة	متوفر عندما: targeting_type = browser_name

مثال

curl --request POST \
--url 'https://qrcloud.online/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'is_enabled=0' \

مثال الاستجابة

{
    "data": {
        "id": 1
    }
}

حذف

النقطة النهائية

DELETE https://qrcloud.online/api/links/{link_id}

مثال

curl --request DELETE \
--url 'https://qrcloud.online/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \

الروابط

استرد كل

Retrieve one

إنشاء

تحديث

حذف