https://github.com/4xmen/persian-json-placeholder

persian json placeholder for front-end developer & mobile developrs
https://github.com/4xmen/persian-json-placeholder

4xmen api json json-api json-api-server persian placeholder placeholderapi rest rest-api restful restful-api xstack

Last synced: 22 days ago
JSON representation

persian json placeholder for front-end developer & mobile developrs

• Host: GitHub
• URL: https://github.com/4xmen/persian-json-placeholder
• Owner: 4xmen
• License: gpl-3.0
• Created: 2023-01-27T15:53:51.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-02-12T23:49:17.000Z (over 2 years ago)
• Last Synced: 2025-04-03T09:02:23.890Z (about 1 month ago)
• Topics: 4xmen, api, json, json-api, json-api-server, persian, placeholder, placeholderapi, rest, rest-api, restful, restful-api, xstack
• Language: PHP
• Homepage: https://json.xstack.ir/
• Size: 18.5 MB
• Stars: 90
• Watchers: 6
• Forks: 22
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 
 Persian Json Placeholder 


 

یکی از ابزار آموزشی برای برنامه‌نویسان Front-end، برنامه‌نویسان موبایل و یادگیری کار با رست‌فول ای‌پی‌آی (API)  استفاده از جی‌سان آزمایشی و جعلی می‌باشد، لذا از همین رو بر این شدیم که یک پلت فرم پارسی برای برنامه‌‌نویسان ایرانی بوجود بیاوریم که بتوانند، آزمایشات و تست خودشون رو انجام دهند.

و این پروژه اوپن سورس بوده و شما هم می‌توانید در آن مشارکت کنید و حتی سرویس شخصی خودتون رو با توجه به نیاز خود راه اندازی کنید. 


# 
 RestfulApi چیست ؟ 




REST API (همچنین به عنوان RESTful API شناخته می شود) یک رابط برنامه نویسی کاربردی (API یا web API) است که با محدودیت های سبک معماری REST مطابقت دارد و امکان تعامل با سرویس های وب RESTful را فراهم می کند. REST مخفف انتقال حالت نمایشی است و توسط متخصصان کامپیوتر روی فیلدینگ ایجاد شده است. 



# 
 چرا باید از RestfulAPi استفاده کنیم؟


 

ممکن است بخواهید برای طراحی یا تست اپلیکیشن یا سایت خود یک سری اطلاعات برای پر کردن دیتابیس داشته باشید . شاید بپرسید این داده ها از کجا دریافت می شوند؟ داده ها از سرور دریافت می شوند. شما به عنوان کلاینت با استفاده از API، درخواست خود را به سرور ارسال می کنید و سرور پاسخ می دهد. داده ها از سمت سرور به صورت HTML برای کاربر ارسال می شوند اما اگر داده ها به صورت ساختیافته و از طریق XML، JSON به کاربر نمایش داده شوند بهتر و منظم تر است. استخراج اطلاعات پروسه پیچیده ای است که به تنهایی از طریق API امکان پذیر نیست و متد ها و توابع زیادی نیاز است. REST API با ایجاد یک مجموعه دیتا ساختیافته مقادیر آن شی را متناسب با درخواست کاربر برای کلاینت ارسال می کند.



# 
روش استفاده از این سرویس 


 روش اول استفاده از axios 


```

axios

    .get(" https://json.xstack.ir/api/v1/users")

    .then((result) => {

      console.log(result)

    })

    .catch((err) => console.log(err));

```

 روش دوم استفاده از jquery  


```

$.get( "ajax/test.html", function( data ) {

  $( ".result" ).html( data );

  alert( "Load was performed." );

});

```

# 
 امکانات این سرویس 


| # | URL                |

| :-------- | :------------------------- |

| `کاربران` |  https://json.xstack.ir/api/v1/users  |

| `کاربر`   |  https://json.xstack.ir/api/v1/user/1  |

| `نوشته‌ها` |  https://json.xstack.ir/api/v1/posts |

| `نوشته`   |  https://json.xstack.ir/api/v1/post/dolt-chyzy-jz-yk-anban-gshadhy-pa  |

| `دسته‌بندی‌ها`   |  https://json.xstack.ir/api/v1/categories  |

| `دسته‌بندی‌`   |   https://json.xstack.ir/api/v1/category/kfsh-mrdanh   |

| `محصولات`   |   https://json.xstack.ir/api/v1/products   |

| `محصول`   |   https://json.xstack.ir/api/v1/product/goshy-mobayl-tktm   |

| `دیدگاه‌ها/نظرات`   |   https://json.xstack.ir/api/v1/comments   |

| `دیدگاه/نظر`   |    https://json.xstack.ir/api/v1/comment/1    |

# 
 گزینه ها 

| # | Example                |

| :-------- | :------------------------- |

| `مرتب‌سازی / sort ` |   https://json.xstack.ir/api/v1/products?sort=view  |

| ` نوع مرتب‌سازی / sortType `   |   https://json.xstack.ir/api/v1/products?sortType=desc   |

| ` محدودیت صفحه ` |   https://json.xstack.ir/api/v1/products?limit=45  |

| ` استفاده هم زمان `   |   https://json.xstack.ir/api/v1/products?limit=45&sort=sell_count&sortType=desc   |


* برای مرتب سازی مقدار بین asc,desc میباشد