Metadata-Version: 2.1
Name: Kenar
Version: 0.5.3
Summary: facilitate using kenar divar APIs
Home-page: https://github.com/divar-ir/kenar-api
Author: Nastaran Alipour
Author-email: nastaran.alipour78@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: httpx>=0.26.0
Requires-Dist: pydantic>=2.6.0

<div dir="rtl">

# kenar-api
## درباره
این کتابخانه برای استفاده ی راحت‌تر و سریع‌تر از سرویس های کنار دیوار توسعه داده شده است.
>توجه: برای استفاده از این کتابخانه باید نیازمند نسخه ی پایتون بالاتر از 3.10 هستید. 

## ویژگی های اصلی
* تولید آدرس ریدایرکت به احراز باز برای دریافت دسترسی ها از کاربر
* امکان ارسال پیام در چت دیوار و ثبت درخواست برای مطلع شدن از پیام های چت دیوار روی یک آگهی
* امکان درج/حذف/دریافت افزونه در آگهی های دیوار
* امکان درج/حذف/دریافت افزونه روی دسته ای از آگهی های یک کاربر (بر اساس دسته بندی آگهی)

## نحوه ی نصب 
برای این منظور میتوانید از پکیج منیجر [pip](https://pip.pypa.io/en/stable/) استفاده کنید

<div dir="ltr">

```bash
pip install Kenar
```
</div>

## راهنمای استفاده
پس از ساخت برنامه در پنل کنار و گرفتن کلید API و کلید محرمانه OAuth مربوط به آن ، با قرار دادن این فیلد ها در environment variable های پروژه ی خود ، میتوانید از این SDK استفاده کنید.  
- [نمونه ساخت اپ](samples/sample_app.py)
- [نمونه ساخت ریدایرکت احراز باز و گرفتن اکسس توکن احراز](samples/sample_oauth.py)
- [نمونه ساخت افزونه آگهی و کاربر](samples/sample_addon.py)
- [نمونه سرچ آگهی با فیلتر، دریافت اطلاعات یک آگهی، آگهی های کاربر و اطلاعات شماره تلفن کاربر](samples/sample_finder.py)
- [نمونه ارسال پیام در چت و اجازه دریافت پیام ها روی یک آگهی](samples/sample_chat.py)

## پیشنهادات برای بهبود
پذیرای هر گونه پیشنهادات شما برای بهتر کردن این کتاب‌خانه هستیم. در قسمت [issues](https://github.com/divar-ir/kenar-api/issues) پروژه میتوانید مسائل خود را با ما مطرح کنید.

## ادرس پنل توسعه دهندگان
[کنار دیوار](divar.ir/kenar)

## مستندات کنار دیوار
در صورتی که از زبان پایتون برای توسعه ی برنامه خود استفاده نمیکنید ، میتوانید با بهره گیری از [مستندات کنار دیوار](https://github.com/divar-ir/kenar-docs) مستقیما اندپوینت های سرویس را فراخوانی کند.
</div>
