وب سرویس حسابداری حسابیت

shape
shape
shape
shape
shape
shape
shape
shape

وب سرویس حسابداری حسابیت

در این مطلب قصد داریم در مورد وب سرویس حسابداری حسابیت توضیح دهیم.

معرفی

API حسابیت وب سرویسی مبتنی بر REST و OAuth 2.0 است که به توسعه دهندگان اجازه میدهد برنامه خود را به حسابیت متصل کنند .

از طریق این وب سرویس شما به تمامی بخش های مختلف حسابیت دسترسی دارید و می توانید اطلاعات را اضافه کنید ، بخوانید ، ویرایش کنید و حذف نمائید .

تعداد درخواس

HTTP Methods

وب سرویس حسابیت ۴ متد HTTP را پشتیبانی می کند :

POST :

از این مدل درخواست فقط برای ایجاد دیتای جدید استفاده می شود .

مانند ایجاد فاکتور جدید

GET :

این نوع درخواست فقط برای خواندن دیتای موجود اسفاده می شود .

مانند خواندن لیست مشتریان
PUT :

از این نوع درخواست فقط برای ویرایش دیتای موجود استفاده می شود .

مانند ویرایش مشخصات یک محصول

DELETE :

این نوع درخواست برای حذف دیتای موجود استفاده می شود .

مانند حذف یک فاکتور

ت (Request) برای هر شناسه ۲۰,۰۰۰ بار در روز خواهد بود ، اگر بیش از این نیاز دارید حتما از طریق تیکت اطلاع دهید .

SSL

وب سرویس حسابیت فقط بروی HTTPS در دسترس است .

https://api.hesabit.com/v1/

JSON

وب سرویس حسابیت از json پشتیبانی میکند و درخواست ها و پاسخ ها به صورت json مبادله خواهد شد .

در Header در خواست ها باید مقدار Content-Type: application/json; وجود داشته باشد .

متغیر های آدرس

برخی مقادیر مانند شناسه ها (ID) در داخل آدرس قرار می گیرند (Path parameters) مانند زمانی که می خواهیم درخواست ویرایش محصول را ارسال کنیم شناسه محصول (Item ID) در آدرس قرار میگیرد : /items/{item_id}

پارامترهای درخواست

برخی مقادیر مانند تعداد رکورد ها (limit) به صورت کوئری در انتهای آدرس قرار می گیرند (Query parameters) مانند زمانی که می خواهیم فقط تعداد ۵ فاکتور (limit=5) پرداخت شده (status=paid) را بگیریم : /invoices?limit=5&status=paid

راهنمای سریع OAuth 2.0

اگر به دنبال جزئیات تنظیمات OAuth هستنید این صفحه را مطالعه کنید .

۱- Client

از طریق پنل کاربری یک client جدید ایجاد کنید .

۲- Authorization

درخواست دسترسی به اطلاعات کاربر باید از طریق آدرس زیر انجام شود . ( شما میتوانید این آدرس را در مروگر خود باز کنید )

دقت کنید که به جای {client_id} و {redirect_uri} مقادیر مربوط به Client که در مرحله قبل ساخته اید را قرار دهید .

۳- Access Token

پس از تائید مرحله قبل مقدار code به آدرسی redirect_uri شما ارسال می شود و در این مرحله باید یک درخواست از نوع POST به آدرس زیر ارسال کنید و در جواب access_token را دریافت کنید .

محتوی درخواست POST :

در پارسخ به این درخواست Access Token و Refresh Token مانند نمونه زیر برای شما ارسال می شود .

نمونه پاسخ به درخواست قبل :

۴- اتصال به وب سرویس

برای کار با وبسرویس کافی است مقدار access_token که در مرحله قبل دریافت کردید در نشانی درخواست ها قرار دهید . (همه درخواست ها به API باید همراه با aceess_token باشد)

۵- Resfresh Token

هر access_token فقط برای ۱۰ ساعت معتبر است و پس از آن منقضی خواهد شد و برای دریافت access_token جدید باید از طریق refresh_token یک access_token جدید بگیرید . برای اینکار یک درخواست از نوع POST به صورت زیر ارسال کنید .

محتوی درخواست POST :

نمونه پاسخ به درخواست قبل :

منبع

پاسخی بگذارید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *