Сілтемелер
GET https://tistos.com/api/links/
curl --request GET \
--url 'https://tistos.com/api/links/' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://tistos.com/api/links/' \
--header 'Authorization: Bearer {api_key}' \
| Параметрлер | Толығырақ | Сипаттама |
|---|---|---|
| search | Міндетті емес Жолақ | Іздеу жолы. |
| search_by | Міндетті емес Жолақ | Сіз қандай сала бойынша іздеп жатырсыз. Рұқсат етілген мәндер: url, location_url. |
| is_enabled | Міндетті емес Логикалық | |
| project_id | Міндетті емес Бүтін сан | |
| domain_id | Міндетті емес Бүтін сан | |
| type | Міндетті емес Жолақ |
biolink, link, file, vcard, event, static |
| 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, clicks, url. |
| 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
},
"clicks": 10,
"order": 0,
"start_date": null,
"end_date": null,
"datetime": "2026-07-18 19:27:03",
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://tistos.com/api/links?page=1",
"last": "https://tistos.com/api/links?page=1",
"next": null,
"prev": null,
"self": "https://tistos.com/api/links?page=1"
}
}
GET https://tistos.com/api/links/{link_id}
curl --request GET \
--url 'https://tistos.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://tistos.com/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
},
"clicks": 10,
"order": 0,
"start_date": null,
"end_date": null,
"datetime": "2026-07-18 19:27:03",
}
}
POST https://tistos.com/api/links
| Параметрлер | Толығырақ | Сипаттама |
|---|---|---|
| type | Міндетті емес Жолақ | link |
| location_url | Қажет Жолақ | Мақсаттың URL-і.Қол жетімді болғанда: is_bulk = 0 |
| location_urls | Қажет Жолақ | Мақсаттың URL-і.Қол жетімді болғанда: is_bulk = 1 |
| url | Міндетті емес Жолақ | Жасалған сілтеменің URL бүркеншік аты. Кездейсоқ жасалған біреуін таңдау үшін бос қалдырыңыз.Қол жетімді болғанда: is_bulk = 0 |
| is_bulk | Міндетті емес Логикалық | |
| domain_id | Міндетті емес Бүтін сан | - |
| project_id | Міндетті емес Бүтін сан | - |
| pixels_ids | Міндетті емес Массив Бүтін сан | - |
| email_reports | Міндетті емес Массив | Хабарландыру өңдеуші идентификаторлары |
| schedule | Міндетті емес Логикалық | - |
| start_date | Міндетті емес Жолақ | Қол жетімді болғанда: schedule = true |
| end_date | Міндетті емес Жолақ | Қол жетімді болғанда: schedule = true |
| clicks_limit | Міндетті емес Бүтін сан | - |
| expiration_url | Міндетті емес Жолақ | - |
| 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 | Міндетті емес Файл | - |
| password | Міндетті емес Жолақ | - |
| forward_query_parameters_is_enabled | Міндетті емес Логикалық | - |
| seo_block | Міндетті емес Логикалық | - |
| utm_source | Міндетті емес Жолақ | - |
| utm_medium | Міндетті емес Жолақ | - |
| utm_campaign | Міндетті емес Жолақ | - |
| targeting_type | Міндетті емес Жолақ | continent_code, country_code, 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://tistos.com/api/links' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'url=example' \
--form 'location_url=https://tistos.com/' \
--url 'https://tistos.com/api/links' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'url=example' \
--form 'location_url=https://tistos.com/' \
{
"data": {
"id": 1
}
}
POST https://tistos.com/api/links/{link_id}
| Параметрлер | Толығырақ | Сипаттама |
|---|---|---|
| location_url | Міндетті емес Жолақ | Мақсаттың URL-і. |
| url | Міндетті емес Жолақ | Жасалған сілтеменің URL бүркеншік аты. Кездейсоқ жасалған біреуін таңдау үшін бос қалдырыңыз. |
| domain_id | Міндетті емес Бүтін сан | - |
| project_id | Міндетті емес Бүтін сан | - |
| pixels_ids | Міндетті емес Массив Бүтін сан | - |
| email_reports | Міндетті емес Массив | Хабарландыру өңдеуші идентификаторлары |
| schedule | Міндетті емес Логикалық | - |
| start_date | Міндетті емес Жолақ | Қол жетімді болғанда: schedule = true |
| end_date | Міндетті емес Жолақ | Қол жетімді болғанда: schedule = true |
| clicks_limit | Міндетті емес Бүтін сан | - |
| expiration_url | Міндетті емес Жолақ | - |
| 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 | Міндетті емес Файл | - |
| password | Міндетті емес Жолақ | - |
| forward_query_parameters_is_enabled | Міндетті емес Логикалық | - |
| seo_block | Міндетті емес Логикалық | - |
| utm_source | Міндетті емес Жолақ | - |
| utm_medium | Міндетті емес Жолақ | - |
| utm_campaign | Міндетті емес Жолақ | - |
| targeting_type | Міндетті емес Жолақ | continent_code, country_code, 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 |
| is_enabled | Міндетті емес Логикалық | - |
curl --request POST \
--url 'https://tistos.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'is_enabled=0' \
--url 'https://tistos.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'is_enabled=0' \
{
"data": {
"id": 1
}
}
DELETE https://tistos.com/api/links/{link_id}
curl --request DELETE \
--url 'https://tistos.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \
--url 'https://tistos.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \