سجل الأن لدينا واحصل على 10 رابط مختصر مجانا تحت اسم منشأتك والروابط لا تحذف ابدا في حسابك

المساحات

Notes
مستوى الخبراء
The API key should be sent as a Bearer token in the Authorization header of the request. Get your API key.
List

نقطة نهاية API:

GET 
https://cut.sa/api/v1/spaces

مثال الطلب: 

curl --location --request GET 'https://cut.sa/api/v1/spaces' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Parameter
النوع
الوصف
search
optional string
The search query.
search_by
optional string
البحث بواسطة. Possible values are: name for الأسم. Defaults to: name.
sort_by
optional string
اختصر بواسطة. Possible values are: id for تاريخ الانشاء, name for الأسم. Defaults to: id.
sort
optional string
قصير. Possible values are: desc for تنازلي, asc for تصاعدي. Defaults to: desc.
per_page
optional integer
النتيجة لكل صفحة. Possible values are: 10, 25, 50, 100. Defaults to: 10.
Show

نقطة نهاية API:

GET 
https://cut.sa/api/v1/spaces/{id}

مثال الطلب: 

curl --location --request GET 'https://cut.sa/api/v1/spaces/{id}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {api_key}'
Store

نقطة نهاية API:

POST 
https://cut.sa/api/v1/spaces

مثال الطلب: 

curl --location --request POST 'https://cut.sa/api/v1/spaces' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}' \
--data-urlencode 'name={name}'
Parameter
النوع
الوصف
name
required string
The space name.
color
optional integer
The color code. Possible values are: 1, 2, 3, 4, 5, 6. Defaults to: 1.
Update

نقطة نهاية API:

PUT PATCH 
https://cut.sa/api/v1/spaces/{id}

مثال الطلب: 

curl --location --request PUT 'https://cut.sa/api/v1/spaces/{id}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {api_key}'
Parameter
النوع
الوصف
name
optional string
The space name.
color
optional integer
The color code. Possible values are: 1, 2, 3, 4, 5, 6.
حذف

نقطة نهاية API:

DELETE 
https://cut.sa/api/v1/spaces/{id}

مثال الطلب: 

curl --location --request DELETE 'https://cut.sa/api/v1/spaces/{id}' \
--header 'Authorization: Bearer {api_key}'