به بخش توسعهدهندگان نوین هاب خوش آمدید
این مستندات جهت آسانی استفاده شما از قابلیتها و امکانات نوین هاب و همچنین توسعه و کامل کردن محصولات خود با استفاده از بسترهای ایجاد شده توسط نوین هاب، جمع آوری شدهاند.
در صورت بروز هر گونه سوال با تیم فنی نوین هاب در بخش تیکتهای پشتیبانی تماس بگیرید تا همکاران فنی در سریعترین زمان به سئوالات شما پاسخ دهند.
شروع به کار
لطفا پیش از شروع به کار این موارد را در نظر داشته باشید:
- وب سرویس نوین هاب به صورت
REST
نوشته شده است. - برای دریافت
Token
به بخش احراز هویت توکن مراجعه کنید. - در صورت نیاز به
OAuth2
حتما در این صفحه فرم را کامل کنید تا با شما تماس بگیریم و هماهنگیهای لازم را انجام دهیم. - در صورت بروز هر گونه سوال با تیم فنی نوین هاب در بخش تیکتهای پشتیبانی تماس بگیرید تا همکاران فنی در سریعترین زمان به سئوالات شما پاسخ دهند.
تمام وب سرویس های نوین هاب نیازمند بخش احراز هویت می باشد. لطفا قبل از استفاده ابتدا مراحل احراز هویت را انجام دهید.
مشخصات API
در هنگام استفاده از API نوین هاب باید نسخه مورد نظر خود را در لینک درخواست مشخص کنید. نسخه با پسوند v
و
شماره آن در لینک ارسال می شود.
برای مثال در صورتی که قصد استفاده از نسخه 1 را دارید، مقدار v1
در لینک درخواست ارسال می شود.
لینک api بر اساس روش های احراز هویت به شرح زیر است
token
در صورت استفاده از توکن لینک درخواست به صورتhttps://api.novinhub.com/token/v{version}
می باشد.در حال حاضر آخرین نسخهv1
و لینک آن به صورتhttps://api.novinhub.com/token/v1
می باشد.OAuth
در صورت استفاده از OAuth لینک درخواست به صورتhttps://api.novinhub.com/v{version}
می باشد.در حال حاضر آخرین نسخهv1
و لینک آن به صورتhttps://api.novinhub.com/v1
می باشد.
Field expansion
برای راحتی و ادغام چند درخواست میتوانید از قابلیت Field expansion استفاده کنید.
مقدار این فیل باید با نام with
در درخواست ارسال شود. شما میتوانید در درخواست چند فیلد را وارد نمایید.
این مقادیر باید با ,
از همدیگر جدا شود.
همچنین شما میتوانید این مقدار را به صورت تو در تو استفاده کنید که در این صورت باید به فرمت
parent(child,...)
ارسال شود.
برای مثال در قسمت Comment شما می توانید فیلدهای عنوان شده در صفحه را استفاده نمایید.
در این مثال نمونه مقدار with
به صورت with=account,socialUser,accountPost
می باشد.
شما همچنین در در مثال بالا میتوانید مقدار meta که یک Field expansion در بخش Account
میباشد را به صورت
with=account(meta),socialUser,accountPost
ارسال کنید.
آپلود فایل
آپلود در وب سرویسهایی که نیازمند آپلود فایل میباشد باید به صورت multipart/form-data
ارسال شود.
صفحه بندی
در صورتی که در یک وب سرویس خروجی تعداد زیادی باشد خروجی به صورت صفحه بندی ارسال میشود.
این خروجی به صورت شی Paginate میباشد که شامل 2 فیلد data
حاوی
اطلاعات درخواستی و paging
با مشصخات زیر میباشد.
total
تعداد کل آیتمهاpage
شماره صفحه کنونیtotalPage
تعداد کل صفحاتnext
آدرس صفحه بعدیprev
آدرس صفحه قبلی
شما میتوانید شماره صفحه دلخواه خود را در درخواست مدنظر با ورودی page
ارسال کنید. یا با کمک فیلدهای
prev و next لینک صفحات بعدی و قبلی را محسابه کنید.
صفحه بندی با اشاره
در صورتی که در یک وب سرویس خروجی تعداد زیادی باشد خروجی به صورت صفحه بندی با اشاره ارسال میشود.
تفاوت اصلی این صفحه بندی عدم وجود شماره صفحه است. در این صفحه بندی بسته به نوع وب سرویس در درخواست مشخص میشود که دادهها از قبل و یا بعد چه دادهای ارسال شود.
این خروجی به صورت شی CursorPagination میباشد که شامل 2 فیلد
data
حاوی
اطلاعات درخواستی و paging
با مشصخات زیر میباشد.
total
تعداد کل آیتمهاafter
آدرس صفحه بعدیbefore
آدرس صفحه قبلی
شما میتوانید شماره صفحه دلخواه خود را در درخواست مدنظر با ورودی after
و یا before
ارسال
کنید. یا با کمک فیلدهای
after و before لینک صفحات بعدی و قبلی را محاسبه کنید.
دقت کنید در درخواستهایی که شامل before
میباشد ممکن است داده ها از تعداد مجاز بیشتر باشد.
دادهها از ابتدا ارسال میشود و مابقی داده ها به کمک فیلد after
فابل دریافت هست. در این حالت هردو فیلد
after
و before
ارسال میشود.
خطاها
وب سرویس نوین هاب در درخواستهای مختلف خطا به صورت آرایه با اندیس
error
ارسال میشود که فرمت آن به صورت
ErrorResponse می باشد.
trace_id
را به همراه مشکل مورد نظر به پشتیبانی فنی نوین هاب ارسال نمایید.
همچنین در صورت بروز خطا مقدار http status به صورت جدول زیر ارسال میشود.
شماره خطا | نوع | توضیحات |
---|---|---|
400 | ValidationException | خطا در اعتبار سنجی درخواست |
401 | HttpException | access_token ارسالی منقضی شده است. |
403 | HttpException | عدم دسترسی به صفحه مورد نظر |
404 | HttpException | صفحه مورد نظر یافت نشد. |
429 | HttpException | محدودیت استفاده از api برای این دستگاه به پایان رسیده است. |
500 | HttpException | خطای داخلی سرور. |
احراز هویت
احراز هویت در نوین هاب به دو صورت توکن و OAuth2 است.
در حالت توکن به سادگی با مراجعه به پنل کاربری میتوانید توکن خود را دریافت کنید.
در حالت OAuth2 لازم است که درخواست ارسال کنید و بعد از هماهنگی لازم آن را دریافت کنید.
برای دریافت OAuth2 لطفا این فرم را کامل کنید.
توکن
در صورتی که نیاز به احراز هویت از طریق توکن هستید در درخواست ها باید مقدار توکن را به صورت query string
با نام token
در درخواست ها ارسال کنید
اگر شما یک اپلیکیشن و یا وبسایت شخصی دارید و قصد استفاده از سرویسهای نوین هاب را برای خود دارید برای دریافت توکن، لطفا اینجا کلیک نمایید.
لینک درخواست ها با کمک توکن به صورت
https://api.novinhub.com/token/v1/account
می باشد.
برای مثال برای دریافت اکانت ها لینک درخواستی به شکل زیر میباشد:
https://api.novinhub.com/token/v1/account?token={token}
OAuth
پروسه احراز هویت بر مبنای oAuth2
می باشد که برای استفاده از سرویس نوین هاب نیاز به
client_id
و client_secret
می باشید.
تعاریف زیر می تواند به درک بهتر مفاهیم به شما کمک کند.
- کاربر : شخصی که در سایت نوین هاب اکانت دارد.
- سرویس : وب سایت یا اپلیکیشینی که قصد استفاده از api نوین هاب را دارد.
- Client id : شناسه سرویس استفاده کننده هست که در هنگام ایجاد سرویس در نوین هاب ساخته میشود.
- Client secret : یک کلید محرمانه می باشد کمه در هنگام ایجاد سرویس در نوین هاب ساخته میشود.
- Access token : توکن دریافتی از انجام عملیات احراز هویت و تایید کاربر. در حال حاضر عمر این توکن یک ماه می باشد.
- Scope : دسترسی مورد نیاز سرویس در اکانت کاربر که با کاراکتر فاصله جدا می شود.
- Refresh token : توکن برای دریافت Access token جدید. در حال حاضر عمر این توکن 1 سال می باشد.
- Redirect uri : لینک بازگشت به سرویس مبدا (لینک می توانید به صورت url باشد یا به صورت deep link ارسال شود)
- Authorization code : کد دریافتی در هنگام بازگشت از لینک برای دریافت Access token
تمام درخواست ها باید به مسیر https:/api.novinhub.com/web/
ارسال شود. برای مثال برای ایجاد توکن کاربر را
به مسیر https:/api.novinhub.com/web/oauth/authorize
هدایت کنید.
ارسال کاربر به نوین هاب
برای دریافت توکن جدید کاربر را به مسیر زیر هدایت کنید
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
client_id | اجباری | Client id |
response_type | اجباری | مقادیر: code: در صورتی که client_secret دارید. token: در صورتی که سرویس شما در سمت کاربر پیاده شده است و امکان ذخیره سازی client_secret نیست. برای مثال سایت شما بر پایه javascript تحت مرورگر می باشد. دقت کنید در این روش refresh_token در خروجی ارسال نمی شود. |
scope | اجباری | Scope |
state | اجباری | توکن csrf که توسط سرویس ایجاد می شود. |
redirect_uri | اختیاری | لینک بازگشت، در صورت وارد نشدن مقدار پیشفرض قرار میگیرد.لینک باید شامل مقدار پیشفرض باشد. |
بعد از انجام احراز هویت و تایید دسترسی ها توسط کاربر کاربر به لینک redirect_url ارسال شده ارسال می گردد. و مقادیر زیر به صورت get ارسال میگردند.
در صورتی که مقدار response_type برابر با code باشد.
نام | نوع | توضیحات |
---|---|---|
code | اختیاری | مقدار authorization_code که در درخواست بعدی استفاده می شود. عمر این کد 30 ثانیه می باشد. |
state | اختیاری | توکن csrf ارسالی از سرویس |
در صورتی که مقدار response_type برابر با token باشد.
نام | نوع | توضیحات |
---|---|---|
state | اختیاری | توکن csrf ارسالی از سرویس |
access_token | اختیاری | توکن اتصال به وب سرویس |
expires_in | اختیاری | اعتبار توکن به ثانیه |
token_type | اختیاری | مقدار ثابت: access_token |
scope | اختیاری | لیست دسترسی ها |
دریافت Access token
در صورتی که مقدار response_type در هنگام هدایت کاربر به نوین هاب را code قرار دهید نیاز دارید تا کد دریافتی در لینک بازگشت را به مسیر زیر برای دریافت access_token ارسال کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
client_id | اجباری | Client id |
client_secret | اجباری | Client secret |
grant_type | اجباری | مقدار ثابت: authorization_code |
code | اجباری | کد دریافتی در لینک بازگشت |
redirect_uri | اجباری | لینک بازگشت، در صورت وارد نشدن در درخواست اولیه مقدار پیشفرض باید ارسال شود. |
خروجی درخواست:
نام | نوع | توضیحات |
---|---|---|
access_token | - | Client id |
expires_in | - | Client secret |
token_type | - | مقدار ثابت: authorization_code |
scope | - | کد دریافتی در لینک بازگشت |
refresh_token | - | لینک بازگشت، در صورت وارد نشدن در درخواست اولیه مقدار پیشفرض باید ارسال شود. |
refresh_token_expires | - | لینک بازگشت، در صورت وارد نشدن در درخواست اولیه مقدار پیشفرض باید ارسال شود. |
دریافت توکن جدید با کمک Refresh token
در صورتی که access token منقضی شده باشد یا نیاز به توکن جدید دارید با ارسال ورودی ها به لینک زیر توکن جدید دریافت کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
client_id | اجباری | Client id |
client_secret | اجباری | Client secret |
grant_type | اجباری | مقدار ثابت: refresh_token |
refresh_token | اجباری | مقدار Refresh token |
خروجی درخواست:
نام | نوع | توضیحات |
---|---|---|
access_token | - | توکن اتصال به وب سرویس |
expires_in | - | اعتبار توکن به ثانیه |
token_type | - | مقدار ثابت: access_token |
scope | - | لیست دسترسی ها |
درخواست جدید با کمک توکن دریافتی
بعد از دریافت access token می توانید از وب سرویس نوین هاب که مستندات آن در لینک https://novinhub.com/developers می باشد استفاده کنید. در درخواست های ارسالی مقدار توکن را با نام access_token در لینک درخواست به صورت query params ارسال کنید.
لینک وب سرویس :
برای مثال
https://api.novinhub.com/v1/account?access_token={token}
لیست scope های موجود :
- basic
- mobile
- offline_access
- implicit_approve
- account
- post
- publish
- insights
- comment
- inbox
پروسه احراز هویت بر مبنای oAuth2
می باشد که برای استفاده از سرویس نوین هاب نیاز به
client_id
و client_secret
می باشید.
تعاریف زیر می تواند به درک بهتر مفاهیم به شما کمک کند.
- کاربر : شخصی که در سایت نوین هاب اکانت دارد.
- سرویس : وب سایت یا اپلیکیشینی که قصد استفاده از api نوین هاب را دارد.
- Client id : شناسه سرویس استفاده کننده هست که در هنگام ایجاد سرویس در نوین هاب ساخته میشود.
- Client secret : یک کلید محرمانه می باشد کمه در هنگام ایجاد سرویس در نوین هاب ساخته میشود.
- Access token : توکن دریافتی از انجام عملیات احراز هویت و تایید کاربر. در حال حاضر عمر این توکن یک ماه می باشد.
- Scope : دسترسی مورد نیاز سرویس در اکانت کاربر که با کاراکتر فاصله جدا می شود.
- Refresh token : توکن برای دریافت Access token جدید. در حال حاضر عمر این توکن 1 سال می باشد.
- Redirect uri : لینک بازگشت به سرویس مبدا (لینک می توانید به صورت url باشد یا به صورت deep link ارسال شود)
- Authorization code : کد دریافتی در هنگام بازگشت از لینک برای دریافت Access token
تمام درخواست ها باید به مسیر https:/api.novinhub.com/web/
ارسال شود. برای مثال برای ایجاد توکن کاربر را
به مسیر https:/api.novinhub.com/web/oauth/authorize
هدایت کنید.
ارسال کاربر به نوین هاب
برای دریافت توکن جدید کاربر را به مسیر زیر هدایت کنید
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
client_id | اجباری | Client id |
response_type | اجباری | مقادیر: code: در صورتی که client_secret دارید. token: در صورتی که سرویس شما در سمت کاربر پیاده شده است و امکان ذخیره سازی client_secret نیست. برای مثال سایت شما بر پایه javascript تحت مرورگر می باشد. دقت کنید در این روش refresh_token در خروجی ارسال نمی شود. |
scope | اجباری | Scope |
state | اجباری | توکن csrf که توسط سرویس ایجاد می شود. |
redirect_uri | اختیاری | لینک بازگشت، در صورت وارد نشدن مقدار پیشفرض قرار میگیرد.لینک باید شامل مقدار پیشفرض باشد. |
بعد از انجام احراز هویت و تایید دسترسی ها توسط کاربر کاربر به لینک redirect_url ارسال شده ارسال می گردد. و مقادیر زیر به صورت get ارسال میگردند.
در صورتی که مقدار response_type برابر با code باشد.
نام | نوع | توضیحات |
---|---|---|
code | اختیاری | مقدار authorization_code که در درخواست بعدی استفاده می شود. عمر این کد 30 ثانیه می باشد. |
state | اختیاری | توکن csrf ارسالی از سرویس |
در صورتی که مقدار response_type برابر با token باشد.
نام | نوع | توضیحات |
---|---|---|
state | اختیاری | توکن csrf ارسالی از سرویس |
access_token | اختیاری | توکن اتصال به وب سرویس |
expires_in | اختیاری | اعتبار توکن به ثانیه |
token_type | اختیاری | مقدار ثابت: access_token |
scope | اختیاری | لیست دسترسی ها |
دریافت Access token
در صورتی که مقدار response_type در هنگام هدایت کاربر به نوین هاب را code قرار دهید نیاز دارید تا کد دریافتی در لینک بازگشت را به مسیر زیر برای دریافت access_token ارسال کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
client_id | اجباری | Client id |
client_secret | اجباری | Client secret |
grant_type | اجباری | مقدار ثابت: authorization_code |
code | اجباری | کد دریافتی در لینک بازگشت |
redirect_uri | اجباری | لینک بازگشت، در صورت وارد نشدن در درخواست اولیه مقدار پیشفرض باید ارسال شود. |
خروجی درخواست:
نام | نوع | توضیحات |
---|---|---|
access_token | - | Client id |
expires_in | - | Client secret |
token_type | - | مقدار ثابت: authorization_code |
scope | - | کد دریافتی در لینک بازگشت |
refresh_token | - | لینک بازگشت، در صورت وارد نشدن در درخواست اولیه مقدار پیشفرض باید ارسال شود. |
refresh_token_expires | - | لینک بازگشت، در صورت وارد نشدن در درخواست اولیه مقدار پیشفرض باید ارسال شود. |
دریافت توکن جدید با کمک Refresh token
در صورتی که access token منقضی شده باشد یا نیاز به توکن جدید دارید با ارسال ورودی ها به لینک زیر توکن جدید دریافت کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
client_id | اجباری | Client id |
client_secret | اجباری | Client secret |
grant_type | اجباری | مقدار ثابت: refresh_token |
refresh_token | اجباری | مقدار Refresh token |
خروجی درخواست:
نام | نوع | توضیحات |
---|---|---|
access_token | - | توکن اتصال به وب سرویس |
expires_in | - | اعتبار توکن به ثانیه |
token_type | - | مقدار ثابت: access_token |
scope | - | لیست دسترسی ها |
درخواست جدید با کمک توکن دریافتی
بعد از دریافت access token می توانید از وب سرویس نوین هاب که مستندات آن در لینک https://novinhub.com/developers می باشد استفاده کنید. در درخواست های ارسالی مقدار توکن را با نام access_token در لینک درخواست به صورت query params ارسال کنید.
لینک وب سرویس :
برای مثال
https://api.novinhub.com/v1/account?access_token={token}
درخواست OAuth
در نوین هاب دو نوع توکن در API قرار داده شده است که توکن کاربر همواره در بخش تنظیمات پروفایل در دسترس شما قرار دارد.
برای توکن OAuth نیاز به هماهنگی با شما داریم و به همین منظور لطفا فرم زیر را برای ما کامل کنید تا در سریعترین زمان با شما تماس بگیریم.
webhook
وب هوک یکی از روشهایی است که به وسیله آن، وباپلیکیشنها میتوانند با هم در ارتباط باشند. با استفاده از وب هوک میتوان از APIهای شخص ثالث در پروژه توسعه اپلیکیشن استفاده کرد. وب هوک این امکان را فراهم میکند که هر گاه یک رویداد (Event) اتفاق افتاد، دادههای آنی (Real-Time) از یک اپلیکیشن به اپلیکیشن دیگر ارسال شوند.
در صورتی که نیاز به دریافت event در هنگام تغییرات در نوین هاب را دارید می توانید از webhook استفاده کنید.
داده های ارسالی با فرمت json به لینک webhook_url که هنگام ثبت client_id، ثبت شده است، ارسال می گردد.
دریافت تغییرات
برای دریافت تغییرات از طریق وب هوک حتما باید Refresh token معتبر به همراه دسترسی offline_access وجود داشته باشد.
ساختار مقدار ارسالی به شکل زیر می باشد:
{
‘type’ => ‘نوع تغییر رخ داده’,
‘user_id’ => ‘شناسه کاربر’,
‘payload’ => ‘محتوی تغییر’
}
- نوع message_created هنگامی رخ می دهد که پیغام جدید (دایرکت) در اکانت کاربر ثبت شود.
- نوع comment_created هنگامی رخ می دهد که کامنت جدید در اکانت کاربر ثبت شود
مقدار payload:
https://novinhub.com/developers#reference-Message
https://novinhub.com/developers#reference-Comment
اکانتها
با کمک این سرویس میتوانید اکانتهای شبکههای اجتماعی مختلف را مدیریت نمایید.
لیست اکانتها
با کمک این سرویس میتوانید لیست تمام اکانتهای کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامتر ها
بدون ورودی
خروجی
آرایه از Account در خروجی ارسال میشود.
همچنین شما میتوانید به کمک Field expansion با ارسال پارامتر with
با
مقدار meta
بر اساس شبکههای اجتماعی مقادیر زیر را دریافت کنید.
تلگرام
نام | نوع | توضیحات |
---|---|---|
botusername | string | نام کاربری ربات سفارشی |
botapikey | string | کلید api ربات اختصاصی |
ایجاد اکانت
با کمک این سرویس میتوانید اکانت جدید اضافه کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
type | string | نوع شبکه اجتماعی اکانت |
redirect | string | لینک بازگشت در صورتی که کاربر به شبکه اجتماعی هدایت شود |
همچنین برای شبکههای اجتماعی در لیست زیر ورودیهای جداگانه نیاز است که در هر بخش ذکر شده است.
پارامترهای Aparat
نام | نوع | توضیحات |
---|---|---|
username | string | نام کاربری شبکه |
password | string | کلمه عبور شبکه |
پارامترهای Bale
نام | نوع | توضیحات |
---|---|---|
username | string | نام کانال شبکه |
botusername | string | (اختیاری) نام کاربری ربات سفارشی |
botapikey | string | (اختیاری) کلید api ربات سفارشی |
پارامترهای Eitaa
نام | نوع | توضیحات |
---|---|---|
username | string | نام کانال شبکه |
token | string | توکن کانال شبکه |
پارامترهای Gap
نام | نوع | توضیحات |
---|---|---|
username | string | نام کانال شبکه |
botusername | string | (اختیاری) نام کاربری ربات سفارشی |
botapikey | string | (اختیاری) کلید api ربات سفارشی |
پارامترهای Soroush
نام | نوع | توضیحات |
---|---|---|
username | string | نام کانال شبکه |
botapikey | string | (اختیاری) کلید api ربات سفارشی |
پارامترهای Telegram
نام | نوع | توضیحات |
---|---|---|
username | string | نام کانال شبکه |
botusername | string | (اختیاری) نام کاربری ربات سفارشی |
botapikey | string | (اختیاری) کلید api ربات سفارشی |
خروجی
شی Account ایجاد شده در خروجی ارسال میشود
و یا در صورتی که نیاز باشد کاربر به شبکه اجتماعی برای گرفتن دسترسی هدایت شود شی RedirectResponse در خروجی ارسال میشود.
مشخصات اکانت
با کمک این سرویس میتوانید مشخصات اکانت با شناسه accountId
را دریافت کنید.
آدرس وب سرویس
:accountId
پارامترها
بدون ورودی
خروجی
شی Account در خروجی ارسال میشود.
ویرایش اکانت
با کمک این سرویس میتوانید اکانت با شناسه accountId
را ویرایش کنید.
آدرس وب سرویس
:accountId
پارامترها
نام | نوع | توضیحات |
---|---|---|
type | string | نوع شبکه اجتماعی اکانت |
redirect | string | لینک بازگشت در صورتی که کاربر به شبکه اجتماعی هدایت شود |
همچنین برای شبکههای اجتماعی در این لیست ورودیهای جداگانه نیاز است که در هر بخش ذکر شده است.
خروجی
شی Account ایجاد شده در خروجی ارسال میشود
و یا در صورتی که نیاز باشد کاربر به شبکه اجتماعی برای گرفتن دسترسی هدایت شود شی RedirectResponse در خروجی ارسال میشود.
حذف اکانت
با کمک این سرویس میتوانید اکانت با شناسه accountId
را حذف کنید.
آدرس وب سرویس
:accountId
پارامتر ها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
گروه اکانتها
با کمک این سرویس میتوانید اکانتهای شبکههای اجتماعی خود را گروه بندی کنید و آنها را در گروههای مختلفی قرار دهید. این گروه بندی برای انتخاب سریعتر در زمان انتشار محتوا کاربرد دارد.
لیست گروه اکانتها
با کمک این سرویس میتوانید لیست تمام گروههای اکانت کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامتر ها
بدون ورودی
خروجی
آرایه از AccountGroup در خروجی ارسال میشود.
ایجاد گروه اکانت
با کمک این سرویس میتوانید گروه اکانت جدید اضافه کنید.
آدرس وب سرویس
پارامتر ها
نام | نوع | توضیحات |
---|---|---|
name | string | عنوان گروه |
account_ids | integer[] | شناسه اکانتها |
خروجی
شی AccountGroup ایجاد شده در خروجی ارسال می شود.
مشخصات گروه اکانت
با کمک این سرویس میتوانید مشصخات گروه اکانت با شناسه accountGroupId
را دریافت کنید.
آدرس وب سرویس
:accountGroupId
پارامتر ها
بدون ورودی
خروجی
شی AccountGroup در خروجی ارسال میشود.
ویرایش گروه اکانت
با کمک این سرویس میتوانید گروه اکانت با شناسه accountGroupId
را ویرایش نمایید.
آدرس وب سرویس
:accountGroupId
پارامتر ها
نام | نوع | توضیحات |
---|---|---|
name | string | عنوان گروه |
account_ids | integer[] | شناسه اکانتها |
خروجی
شی AccountGroup ویرایش شده در خروجی ارسال میشود.
حذف گروه اکانت
با کمک این سرویس میتوانید گروه اکانت با شناسه accountGroupId
را حذف کنید.
آدرس وب سرویس
:accountGroupId
پارامتر ها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
کپشنها
با کمک این سرویس میتوانید کپشنهای آماده برای اکانت درج کنید و در هنگام ارسال پست از آنها استفاده نمایید.
لیست کپشنها
با کمک این سرویس میتوانید لیست تمام کپشن های کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
آرایه از Caption در خروجی ارسال میشود.
ایجاد کپشن
با کمک این سرویس میتوانید کپشن جدید اضافه کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
title | string | عنوان کپشن |
caption | string | متن کپشن |
خروجی
شی Caption ایجاد شده در خروجی ارسال میشود.
مشخصات کپشن
با کمک این سرویس میتوانید مشصخات کپشن با شناسه captionId
را دریافت کنید.
آدرس وب سرویس
:captionId
پارامترها
بدون ورودی
خروجی
شی Caption در خروجی ارسال میشود.
ویرایش کپشن
با کمک این سرویس میتوانید کپشن با شناسه captionId
را ویرایش نمایید.
آدرس وب سرویس
:captionId
پارامترها
نام | نوع | توضیحات |
---|---|---|
title | string | عنوان کپشن |
caption | string | متن کپشن |
خروجی
شی Caption ویرایش شده در خروجی ارسال میشود.
حذف کپشن
با کمک این سرویس میتوانید کپشن با شناسه captionId
را حذف کنید.
آدرس وب سرویس
:captionId
پارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
کامنتها
با کمک این سرویس میتوانید کامنتهای دریافت شده در شبکههای اجتماعی را در یک داشبورد مدیریت کنید.
تمامی قابلیتهای مشاهده، پاسخ و حذف در دسترس است و همچنین نوین هاب قابلیتهای بیشتری نیز همچون ایجاد برچسب و دسته بندی، دریافت فایل خروجی و… را نیز در اختیار شما قرار میدهد.
لیست کامنتها
با کمک این سرویس میتوانید لیست کامنتهای کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
tag | integer[] | (اختیاری) فیلتر شناسه تگهای کامنت |
status | string | (اختیاری) فیلتر وضعیت کامنت |
date_from | string | (اختیاری) فیلتر کامنتهای بعد از تاریخ |
date_to | string | (اختیاری) فیلتر کامنتهای قبل از تاریخ |
search | string | (اختیاری) جستجوی در متن کامنت |
دریافت کامنت ها بر اساس قبل و بعد تاریخ
برای فیلتر کامنت ها در بازه زمانی خاص می توانید با کمک فیلد های after و before فیلتر مورد نظر خودتان را اعمال کنید. برای مثال برای دریافت کامنت ها قبل از تاریخ 01-01-2022 مقدار after=2022-01-01 را به صورت GET ارسال کنید.
دقت کنید که خروجی این endpoint نزولی هست و after و before به معانی صفحه بعد و قبل می باشد، بنابراین اگر داده های قبل تاریخ مد نظر را میخواهید از فیلد after در غیر این صورت از فیلد before استفاده کنید. برای اطلاعات بیشتر به بخش صفحهبندی با اشاره مراجعه کنید
نمونه
خروجی
آرایه از Comment در فرمت CursorPagination در خروجی ارسال میشود.
برای اطلاعات بیشتر به بخش صفحهبندی با اشاره مراجعه کنید.
مشخصات کامنت
با کمک این سرویس میتوانید مشخصات کامنت با شناسه commentId
را دریافت کنید.
آدرس وب سرویس
:commentId
پارامترها
بدون ورودی
خروجی
شی Comment در خروجی ارسال میشود.
پاسخهای کامنت
با کمک این سرویس میتوانید لیست پاسخهای کامنت با شناسه commentId
را دریافت کنید.
آدرس وب سرویس
:commentId
/repliesپارامترها
بدون ورودی
خروجی
آرایه از Comment در فرمت Pagination در خروجی ارسال میشود.
برای اطلاعات بیشتر به بخش صفحهبندی مراجعه کنید.
ارسال پاسخ به کامنت
با کمک این سرویس میتوانید پاسخ جدید بر کامنت با شناسه commentId
اضافه کنید.
آدرس وب سرویس
:commentId
/replyپارامترها
نام | نوع | توضیحات |
---|---|---|
comment | string | متن کامنت |
username | string | نام کاربری کامنت اصلی |
خروجی
شی Comment ایجاد شده در خروجی ارسال میشود.
لایک کامنت
با کمک این سرویس میتوانید لایک به کامنت با شناسه commentId
اضافه یا حذف کنید.
آدرس وب سرویس
:commentId
/likeپارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
تغییر تگ کامنت
با کمک این سرویس میتوانید تگهای کامنت با شناسه commentId
را بروزرسانی کنید.
آدرس وب سرویس
:commentId
/tagپارامترها
نام | نوع | توضیحات |
---|---|---|
tag | integer[] | شناسه تگ کامنت |
خروجی
شی Comment ویرایش شده در خروجی ارسال میشود.
حذف کامنت
با کمک این سرویس میتوانید کامنت با شناسه commentId
را حذف کنید.
آدرس وب سرویس
:commentId
پارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
فعال سازی کامنت اکانت
با کمک این سرویس میتوانیداکانت های مورد نظر را برای دریافت کامنت فعال نمایید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
account_ids | integer[] | شناسه اکانتها |
خروجی
شی BooleanResponse در خروجی ارسال میشود.
مشخصات ارسال کننده
با کمک این سرویس میتوانید مشصخات کاربر ارسال کننده کامنت با شناسه socialUserId
را دریافت کنید.
آدرس وب سرویس
:socialUserId
پارامترها
بدون ورودی
خروجی
شی SocialUser در خروجی ارسال میشود.
مشخصات پست کامنت
با کمک این سرویس میتوانید مشصخات پست کامنت با شناسه commentId
را دریافت کنید.
آدرس وب سرویس
:commentId
/postپارامترها
بدون ورودی
خروجی
شی AccountPost در خروجی ارسال میشود.
تگ کامنتها
با کمک این سرویس میتوانید تگ (برچسب) به کامنتها اضافه کنید.
با استفاده از این قابلیت میتوانید کامنتها را دسته بندی کنید.
لیست تگ کامنتها
با کمک این سرویس میتوانید لیست تمام تگ های کامنت کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
آرایه از CommentTag در خروجی ارسال میشود.
ایجاد تگ کامنت
با کمک این سرویس میتوانید تگ کامنت جدید اضافه کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
name | string | نام تگ |
color | string | کد HEX رنگ |
خروجی
شی CommentTag ایجاد شده در خروجی ارسال میشود.
مشخصات تگ کامنت
با کمک این سرویس میتوانید مشخصات تگ کامنت با شناسه commentTagId
را دریافت کنید.
آدرس وب سرویس
:commentTagId
پارامتر ها
بدون ورودی
خروجی
شی CommentTag در خروجی ارسال میشود.
ویرایش تگ کامنت
با کمک این سرویس میتوانید تگ کامنت با شناسه commentTagId
را ویرایش نمایید.
آدرس وب سرویس
:commentTagId
پارامترها
نام | نوع | توضیحات |
---|---|---|
name | string | نام تگ |
color | string | کد HEX رنگ |
خروجی
شی CommentTag ویرایش شده در خروجی ارسال میشود.
حذف تگ کامنت
با کمک این سرویس میتوانید تگ کامنت با شناسه commentTagId
را حذف کنید.
آدرس وب سرویس
:commentTagId
پارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
مکالمهها
با کمک سرویس مکالمهها در نوین هاب میتوانید تمامی پیامهای دایرکت (پیام مستقیم) را در شبکههای اجتماعی خود از طریق نوین هاب مدیریت کنید.
امکان پاسخگویی، دستهبندی، مشاهده همزمان و … در نوین هاب برای مدیریت راحتتر و بهتر پیامها فراهم شده است.
لیست مکالمهها
با کمک این سرویس میتوانید لیست مکالمههای کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
tag | integer[] | (اختیاری) فیلتر شناسه تگهای مکالمه |
status | string | (اختیاری) فیلتر وضعیت مکالمه |
search | string | (اختیاری) جستجوی در مکالمه |
دریافت مکالمه ها بر اساس قبل و بعد تاریخ
برای فیلتر مکالمه ها در بازه زمانی خاص می توانید با کمک فیلد های after و before فیلتر مورد نظر خودتان را اعمال کنید. برای مثال برای دریافت مکالمه ها قبل از تاریخ 01-01-2022 مقدار after=2022-01-01 را به صورت GET ارسال کنید.
دقت کنید که خروجی این endpoint نزولی هست و after و before به معانی صفحه بعد و قبل می باشد، بنابراین اگر داده های قبل تاریخ مد نظر را میخواهید از فیلد after در غیر این صورت از فیلد before استفاده کنید. برای اطلاعات بیشتر به بخش صفحهبندی با اشاره مراجعه کنید
نمونه
خروجی
آرایه از Conversation در فرمت CursorPagination در خروجی ارسال می شود.
برای اطلاعات بیشتر به بخش صفحهبندی با اشاره مراجعه کنید.
مشخصات مکالمه
با کمک این سرویس میتوانید مشخصات مکالمه با شناسه conversationId
را دریافت کنید.
آدرس وب سرویس
:conversationId
پارامترها
بدون ورودی
خروجی
شی Conversation در خروجی ارسال میشود.
لیست پیغامها
با کمک این سرویس میتوانید لیست تمام پیغامهای مکالمه با شناسه conversationId
کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
:conversationId
/messagesپارامترها
نام | نوع | توضیحات |
---|---|---|
date_from | string | (اختیاری) فیلتر کامنتهای بعد از تاریخ |
date_to | string | (اختیاری) فیلتر کامنتهای قبل از تاریخ |
خروجی
آرایه از Message در خروجی ارسال میشود.
مشخصات پیغام
با کمک این سرویس میتوانید مشخصات پیغام با شناسه messageId
را دریافت کنید.
آدرس وب سرویس
:messageId
پارامترها
بدون ورودی
خروجی
شی Message در خروجی ارسال میشود.
ارسال پاسخ به مکالمه
با کمک این سرویس میتوانید پاسخ جدید بر مکالمه با شناسه conversationId
اضافه کنید.
آدرس وب سرویس
:conversationId
/replyپارامترها
نام | نوع | توضیحات |
---|---|---|
content | string | متن پیغام |
attachment | File | (اختیاری) فایل ارسالی در پیغام |
برای اطلاعات بیشتر به بخش آپلود فایل مراجعه کنید.
خروجی
شی Message ایجاد شده در خروجی ارسال میشود.
اکشن روی پیغام
با کمک این سرویس میتوانید اکشن به مکامله با شناسه conversationId
اضافه یا حذف کنید.
آدرس وب سرویس
:messageId
/reactionپارامترها
نام | نوع | توضیحات |
---|---|---|
type | string | نوع اکشن در حال حاضر فقط مقدار like پشتیبانی میشود. |
خروجی
شی BooleanResponse در خروجی ارسال میشود.
تغییر تگ مکالمه
با کمک این سرویس میتوانید تگهای مکالمه با شناسه conversationId
را بروزرسانی کنید.
آدرس وب سرویس
:conversationId
/tagپارامترها
نام | نوع | توضیحات |
---|---|---|
tag | integer[] | شناسه تگ مکالمه |
خروجی
شی Conversation ویرایش شده در خروجی ارسال میشود.
فعال سازی دایرکت اکانت
با کمک این سرویس میتوانیداکانتهای مورد نظر را برای دریافت مکالمه فعال نمایید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
account_ids | integer[] | شناسه اکانتها |
خروجی
شی BooleanResponse در خروجی ارسال میشود.
تگ مکالمهها
با کمک این سرویس میتوانید تگ (برچسب) به مکالکهها اضافه کنید.
با این قابلیت میتوانید مکالمهها را به سادگی دسته بندی کنید.
لیست تگ مکالمهها
با کمک این سرویس میتوانید لیست تمام تگهای مکالمه کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
آرایه از ConversationTag در خروجی ارسال میشود.
ایجاد تگ مکالمه
با کمک این سرویس میتوانید تگ مکالمه جدید اضافه کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
شی ConversationTag ایجاد شده در خروجی ارسال میشود.
مشخصات تگ مکالمه
با کمک این سرویس میتوانید مشخصات تگ مکالمه با شناسه conversationTagId
را دریافت کنید.
آدرس وب سرویس
:conversationTagId
پارامترها
بدون ورودی
خروجی
شی ConversationTag در خروجی ارسال میشود.
ویرایش تگ مکالمه
با کمک این سرویس میتوانید تگ مکالمه با شناسه conversationTagId
را ویرایش نمایید.
آدرس وب سرویس
:conversationTagId
پارامترها
بدون ورودی
خروجی
شی ConversationTag ویرایش شده در خروجی ارسال میشود.
حذف تگ مکالمه
با کمک این سرویس میتوانید تگ مکالمه با شناسه conversationTagId
را حذف کنید.
آدرس وب سرویس
:conversationTagId
پارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
مدیریت فایلها
با کمک این سرویس میتوانید فایل جدید آپلود کنید و یا فایلهای موجود را مدیریت نمایید برای مشاهده وضعیت فضای استفاده شده از me/files استفاده نمایید.
لیست فایلها
با کمک این سرویس میتوانید لیست تمام فایلهای کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
type | string | (اختیاری) فیلتر نوع غایل |
search | string | (اختیاری) جستجوی در نام فایل |
خروجی
آرایه از File در فرمت Pagination در خروجی ارسال میشود.
برای اطلاعات بیشتر به بخش صفحه بندی مراجعه کنید.
آپلود فایل
با کمک این سرویس میتوانید فایل جدید اضافه کنید.
آدرس وب سرویس
خروجی
شی File ایجاد شده در خروجی ارسال میشود.
مشخصات فایل
با کمک این سرویس میتوانید مشخصات فایل با شناسه fileId
را دریافت کنید.
آدرس وب سرویس
:fileId
پارامترها
بدون ورودی
خروجی
شی File در خروجی ارسال میشود.
حذف فایل
با کمک این سرویس میتوانید فایل با شناسه fileId
را حذف کنید.
آدرس وب سرویس
:fileId
پارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
آنالیز
با استفاده از این سرویس میتوانید اکانتها یا محتواهای منتشر شده را آنالیز کنید و دیتاهای کاملی از وضعیت آنها دریافت کنید.
آنالیز اکانت
با کمک این سرویس میتوانید لیست تمام پیغامهای مکالمه با شناسه conversationId
کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
:accountId
پارامترها
نام | نوع | توضیحات |
---|---|---|
metric | string[] | نوع دادههای درخواستی |
period | string | یکی از مقادیر week، month، three_months، lifetime و یا custom |
date_from | string | (اختیاری) تاریخ شروع در صورت custom |
date_to | string | (اختیاری) تاریخ پایان در صورت custom |
خروجی
شی InsightsResponse در خروجی ارسال میشود.
آنالیز پست
با کمک این سرویس میتوانید داده های آنالیز گروه پست با شناسه postGroupId
کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
:postGroupId
پارامترها
نام | نوع | توضیحات |
---|---|---|
metric | string[] | نوع دادههای درخواستی |
period | string | یکی از مقادیر week، month، three_months، lifetime و یا custom |
date_from | string | (اختیاری) تاریخ شروع در صورت custom |
date_to | string | (اختیاری) تاریخ پایان در صورت custom |
خروجی
شی InsightsResponse در خروجی ارسال میشود.
اطلاعات کاربر
این سرویس مشخصات کاربر وارد شده با توکن را نشان میدهد، تمامی تاریخها و زمانها به فرمت موجود در این قسمت به خروجی ارسال میشود.
مشخصات کاربر
با کمک این سرویس میتوانید مشخصات کاربر فعلی را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
شی User در خروجی ارسال میشود.
مشخصات فایل
با کمک این سرویس میتوانید مشخصات فضای ذخیرهسازی کاربر وارد شده را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
شی StorageInfo در خروجی ارسال میشود.
پستها
در این سرویس شما میتوانید پستهای مختلف ارسال نمایید.
لیست گروه پستها
با کمک این سرویس میتوانید لیست گروه پستهای کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
account_ids | integer[] | (اختیاری) فیلتر شناسههای اکانت |
order | string | (اختیاری) تعیین نحوه مرتب سازی پست یکی از مقادیر id یا schedule_date |
publish_from | string | (اختیاری) فیلتر پستهای بعد از تاریخ |
publish_to | string | (اختیاری) فیلتر پستهای قبل از تاریخ |
خروجی
آرایه از PostGroup در فرمت Pagination در خروجی ارسال می شود.
برای اطلاعات بیشتر به بخش صفحه بندی مراجعه کنید.
ایجاد پست
با کمک این سرویس میتوانید پست جدید اضافه کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
caption | string | متن کپشن |
custom_captions | Object | (اختیاری) کپشنهای سفارشی بر اساس شبکه اجتماعی. اندیس هر عضو نام شبکه اجتماعی و مقدار آن کپشن سفارشی میباشد. |
type | string | نوع پست ( یکی از مقادیر text، image، album، video, document یا story ) |
account_ids | integer[] | شناسه اکانت |
media_ids | integer[] | شناسه فایل |
is_scheduled | 0|1 | زمانبندی بودن پست |
schedule_date | integer | تاریخ زمانبندی پست بر اساس UTC |
is_draft | 0|1 | پیش نویس بودن پست |
location | string | مقدار value موقعیت دریافت شده از جستجوی موقعیت مکانی |
hashtag | string[] | (اختیاری) هشتگ |
photo_tags | Object | (اختیاری) آرایه از تگهای تصویر. اندیس هر عضو آرایه برابر با شناسه فایل مورد نظر میباشد. مقدار هر عضو یک ارایه به مقدایر locationX، locationY، text و id میباشد. مقدار id برابر با pk از بخش جستجوی کاربر میباشد. |
همچنین برای شبکههای اجتماعی در لیست زیر ورودی های جداگانه نیاز است که در هر بخش ذکر شده است.
پارامترهای Aparat
نام | نوع | توضیحات |
---|---|---|
aparat_category | string | شناسه دسته بندی |
aparat_title | string | عنوان ویدیو |
پارامترهای InstagramOfficial
نام | نوع | توضیحات |
---|---|---|
thumbnail_second | Object | ثانیه ویدیو برای پیش نمایش. اندیس هر عضو برابر شناسه فایل و مقدار آن ثانیه میباشد. |
reels | 0|1 | پست به شکل ریلز ارسال میشود. |
reels_sharetofeed | 0|1 | ارسال ریلز به فید. |
پارامترهای Instagram
نام | نوع | توضیحات |
---|---|---|
sticker | Sticker[] | استکیرهای استوری |
thumbnail_second | Object | ثانیه ویدیو برای پیش نمایش. اندیس هر عضو برابر شناسه فایل و مقدار آن ثانیه میباشد. |
igtv | string | ارسال پست به صورت IGTV |
igtv_title | string | عنوان ویدیو IGTV |
igtv_sharetofeed | string | ارسال IGTV به فید |
video_cover | string | شناسه فایل به صورت تصویر برای پیش نمایش ویدیو |
پارامترهای Linkedin
نام | نوع | توضیحات |
---|---|---|
linkedin_title | string | عنوان ویدیو |
پارامترهای Pinterest
نام | نوع | توضیحات |
---|---|---|
pinterest_url | string | لینک پین |
پارامترهای Telegram
نام | نوع | توضیحات |
---|---|---|
thumbnail_second | Object | ثانیه ویدیو برای پیش نمایش. اندیس هر عضو برابر شناسه فایل و مقدار آن ثانیه میباشد. |
telegram_buttons | array | دکمههای شیشهای. هر عضو ارایه شامل یک رشته به فرمت title:link میباشد. |
پارامترهای Twitter
نام | نوع | توضیحات |
---|---|---|
tweets | string[] | آرایه از متن توییتها برای رشته توییت |
پارامترهای Youtube
نام | نوع | توضیحات |
---|---|---|
youtube_category | string | شناسه دسته بندی |
youtube_title | string | عنوان ویدیو |
youtube_privacy | string | یکی از سه مقدار public - private - unlisted |
خروجی
شی Post ایجاد شده در خروجی ارسال میشود
مشخصات گروه پست
با کمک این سرویس میتوانید مشخصات گروه پست با شناسه postGroupId
را دریافت کنید.
آدرس وب سرویس
:postGroupId
پارامترها
بدون ورودی
خروجی
شی PostGroup در خروجی ارسال میشود.
مشخصات پست
با کمک این سرویس میتوانید مشخصات پست با شناسه postId
را دریافت کنید.
آدرس وب سرویس
:postId
پارامترها
بدون ورودی
خروجی
شی Post در خروجی ارسال میشود.
ویرایش پست
با کمک این سرویس میتوانید پست با شناسه postGroupId
را ویرایش کنید.
آدرس وب سرویس
:postGroupId
پارامترها
نام | نوع | توضیحات |
---|---|---|
caption | string | متن کپشن |
custom_captions | Object | (اختیاری) کپشنهای سفارشی بر اساس شبکه اجتماعی. اندیس هر عضو نام شبکه اجتماعی و مقدار آن کپشن سفارشی میباشد. |
type | string | نوع پست ( یکی از مقادیر text، image، album، video یا document ) |
account_ids | integer[] | شناسه اکانت |
media_ids | integer[] | شناسه فایل |
is_scheduled | 0|1 | زمانبندی بودن پست |
schedule_date | integer | تاریخ زمانبندی پست بر اساس UTC |
is_draft | 0|1 | پیش نویس بودن پست |
location | string | مقدار value موقعیت دریافت شده از جستجوی موقعیت مکانی |
hashtag | string[] | (اختیاری) هشتگ |
photo_tags | Object | (اختیاری) آرایه از تگهای تصویر. اندیس هر عضو آرایه برابر با شناسه فایل مورد نظر میباشد. مقدار هر عضو یک ارایه به مقدایر locationX، locationY، text و id میباشد |
همچنین برای شبکههای اجتماعی در این لیست ورودیهای جداگانه نیاز است که در هر بخش ذکر شده است.
خروجی
شی Post ایجاد شده در خروجی ارسال میشود
ویرایش پست بعد از انتشار
با کمک این سرویس میتوانید پست با شناسه postGroupId
را ویرایش کنید.
در حال حاضر ویرایش برای شبکههای Telegram و Instagram پشتیبانی میشود.
آدرس وب سرویس
:postGroupId
/editپارامترها
نام | نوع | توضیحات |
---|---|---|
caption | string | متن کپشن |
custom_captions | Object | (اختیاری) کپشنهای سفارشی بر اساس شبکه اجتماعی. اندیس هر عضو نام شبکه اجتماعی و مقدار آن کپشن سفارشی می باشد. |
type | string | نوع پست ( یکی از مقادیر text، image، album، video یا document ) |
account_ids | integer[] | شناسه اکانت |
media_ids | integer[] | شناسه فایل |
is_scheduled | 0|1 | زمانبندی بودن پست |
schedule_date | integer | تاریخ زمانبندی پست بر اساس UTC |
is_draft | 0|1 | پیش نویس بودن پست |
location | string | مقدار value موقعیت دریافت شده از جستجوی موقعیت مکانی |
hashtag | string[] | (اختیاری) هشتگ |
photo_tags | Object | (اختیاری) آرایه از تگهای تصویر. اندیس هر عضو آرایه برابر با شناسه فایل مورد نظر میباشد. مقدار هر عضو یک ارایه به مقدایر locationX، locationY، text و id میباشد |
همچنین برای شبکههای اجتماعی در این لیست ورودیهای جداگانه نیاز است که در هر بخش ذکر شده است.
خروجی
شی Post ایجاد شده در خروجی ارسال میشود
تلاش مجدد پست
با کمک این سرویس میتوانید گروه پست با شناسه postGroupId
را برای تلاش مجدد ثبت کنید.
آدرس وب سرویس
:postGroupId
/retryپارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
لغو پست
با کمک این سرویس میتوانید گروه پست با شناسه postGroupId
را کنسل کنید.
آدرس وب سرویس
:postGroupId
/cancelپارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
حذف پست
با کمک این سرویس میتوانید گروه پست با شناسه postGroupId
را حذف کنید.
آدرس وب سرویس
:postGroupId
پارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
لیست پیش نویسها
با کمک این سرویس میتوانید لیست گروه پستهای پیشنویس کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
آرایه از PostGroup در فرمت Pagination در خروجی ارسال میشود.
برای اطلاعات بیشتر به بخش صفحه بندی مراجعه کنید.
جستجو
در این قسمت میتوانید از سرویس جستجو برای برخی از بخشها همچون هشتگ، لوکیشن، استکیر و ...استفاده کنید.
جستجو موقعیت مکانی
با کمک این سرویس میتوانید هشتگهای مشابه هشتگ ارسالی را جستجو کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
query | string | متن جستجو |
account_ids | string | شناسه اکانت |
خروجی
آرایه از SearchLocation در خروجی ارسال میشود.
جستجو کاربران
با کمک این سرویس میتوانید هشتگهای مشابه هشتگ ارسالی را جستجو کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
query | string | متن جستجو |
account_ids | string | شناسه اکانت |
خروجی
آرایه از SearchPeople در خروجی ارسال میشود.
جستجو هشتگ مشابه
با کمک این سرویس میتوانید هشتگهای مشابه هشتگ ارسالی را جستجو کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
query | string | متن جستجو |
account_ids | string | شناسه اکانت |
خروجی
آرایه از string در خروجی ارسال میشود.
استیکر
با کمک این سرویس میتوانید Sticker های مختلف به محتوای منتشر شده در استوریهای اینستاگرام اضافه کنید.
باتوجه به بروزرسانیهای متعدد اینستاگرام ممکن است همه استیکرها در نوین هاب پشتیبانی نشوند.
تولید عکس استیکر
با کمک این سرویس میتوانید تصویر بر اساس استکیرهای ارسالی را دریافت کنید.
آدرس وب سرویس
:fileId
/generateImageپارامترها
نام | نوع | توضیحات |
---|---|---|
sticker | Sticker[] | استکیرهای استوری |
خروجی
شی GenerateImage در خروجی ارسال میشود.
استیکرهای استوری
انواع استیکر های استوری در اینستاگرام
- هشتگ
- منشن
- متن
- شمارنده زمان
- سوال
- اسلاید
- نظرسنجی
- کوییز
در نظر داشته باشید که شما می توانید از استیکرهای مختلف استفاده کنید، اما فقط یک بار مجاز به استفاده از هر نوع استیکر در استوری می باشید.
مقدار index می تواند با توجه به تعداد استیکر های مورد نظر شما تنظیم گردد.
انواع مکان های قابل استفاده (sticker position)
- left_top
- left_center
- left_bottom
- right_top
- right_center
- right_bottom
- center_top
- center_center
- center_bottom
پارامترهای استیکر هشتگ
نام | نوع | توضیحات |
---|---|---|
sticker[index][type] | hashtag | نوع |
sticker[index][input] | string | متن هشتگ |
sticker[index][position] | string | مکان استیکر |
پارامترهای استیکر منشن
نام | نوع | توضیحات |
---|---|---|
sticker[index][type] | mention | نوع |
sticker[index][input] | string | شناسه کاربری |
sticker[index][position] | string | مکان استیکر |
در صورت عدم وجود حساب کاربری منطبق با شناسه، استیکر ساخته نخواهد شد.
پارامترهای استیکر متن
نام | نوع | توضیحات |
---|---|---|
sticker[{index}][type] | text | نوع |
sticker[{index}][input] | string | متن |
sticker[{index}][position] | string | مکان استیکر |
پارامترهای استیکر شمارنده زمان
نام | نوع | توضیحات |
---|---|---|
sticker[index][type] | countdown | نوع |
sticker[index][input] | string | متن |
sticker[index][position] | string | مکان استیکر |
sticker[index][end_ts] | timestamp | زمان |
sticker[index][text_color] | string | رنگ متن |
sticker[index][start_background_color] | string | رنگ شروع زمینه |
sticker[index][end_background_color] | string | رنگ پایان زمینه |
sticker[index][following_enabled] | 0 یا 1 | مشترک شدن با دنبال کنندگان |
sticker[index][scale] | float(0.1 to 2) | تغییر سایز |
پارامترهای استیکر سوال
نام | نوع | توضیحات |
---|---|---|
sticker[index][type] | question | نوع |
sticker[index][input] | string | متن |
sticker[index][position] | string | مکان استیکر |
sticker[index][scale] | float(0.1 to 2) | تغییر سایز |
sticker[index][text_color] | string | رنگ متن |
sticker[index][background_color] | string | رنگ زمینه |
پارامترهای استیکر اسلاید
نام | نوع | توضیحات |
---|---|---|
sticker[index][type] | slider | نوع |
sticker[index][input] | string | متن |
sticker[index][position] | string | مکان استیکر |
sticker[index][scale] | float(0.1 to 2) | تغییر سایز |
sticker[index][text_color] | string | رنگ متن |
sticker[index][background_color] | string | رنگ زمینه |
sticker[index][emoji] | emoji | ایموجی |
پارامترهای استیکر نظرسنجی
نام | نوع | توضیحات |
---|---|---|
sticker[index][type] | poll | نوع |
sticker[index][input] | string | متن |
sticker[index][position] | string | مکان استیکر |
sticker[index][scale] | float(0.1 to 2) | تغییر سایز |
[]sticker[index][tallies] | string-یک بار به ازای هر پاسخ | متن پاسخ |
تعداد پاسخ بایستی دو مورد باشد.
پارامترهای استیکر کوییز
نام | نوع | توضیحات |
---|---|---|
sticker[index][type] | quiz | نوع |
sticker[index][input] | string | متن |
sticker[index][position] | string | مکان استیکر |
[]sticker[index][options] | string-یک بار به ازای هر پاسخ | متن پاسخ |
sticker[index][correct_answer] | integer | شناسه(index) پاسخ درست |
sticker[index][scale] | float(0.1 to 2) | تغییر سایز |
sticker[index][text_color] | string | رنگ متن |
sticker[index][start_background_color] | string | رنگ شروع زمینه |
sticker[index][end_background_color] | string | رنگ پایان زمینه |
تیکتها
با کمک این سرویس میتوانید تیکت یا همان پیام پشتیبانی در نوین هاب ایجاد کنید و با بخشهای مختلف پشتیبانی در ارتباط باشید.
درحال حاضر تیکتها در نوین هاب به صورت ۲۴ ساعته پاسخ داده میشوند.
لیست تیکتها
با کمک این سرویس میتوانید لیست تیکت های کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
آرایه از Ticket در فرمت Pagination در خروجی ارسال میشود.
برای اطلاعات بیشتر به بخش صفحه بندی مراجعه کنید.
لیست واحدهای پشتیبانی
با کمک این سرویس میتوانید لیست تمام واحدهای پشتیبانی را دریافت کنید.
آدرس وب سرویس
پارامترها
بدون ورودی
خروجی
آرایه از Department در خروجی ارسال میشود.
ایجاد تیکت
با کمک این سرویس میتوانید تیکت جدید ایجاد کنید.
آدرس وب سرویس
پارامترها
نام | نوع | توضیحات |
---|---|---|
content | string | عنوان تیکت |
department_id | string | شناسه واحد پشتیبانی |
content | string | متن پیغام |
attachment | File | (اختیاری) فایل ارسالی در پیغام |
برای اطلاعات بیشتر به بخش آپلود فایل مراجعه کنید.
خروجی
شی Ticket ویرایش شده در خروجی ارسال میشود.
مشخصات تیکت
با کمک این سرویس میتوانید مشخصات تیکت با شناسه ticketId
را دریافت کنید.
آدرس وب سرویس
:ticketId
پارامترها
بدون ورودی
خروجی
شی Ticket در خروجی ارسال میشود.
لیست پاسخهای تیکت
با کمک این سرویس میتوانید لیست تمام پیغامهای تیکت با شناسه ticketId
کاربر مورد نظر را دریافت کنید.
آدرس وب سرویس
:ticketId
/metaپارامترها
بدون ورودی
خروجی
آرایه از TicketMeta در خروجی ارسال میشود.
ارسال پاسخ به تیکت
با کمک این سرویس میتوانید پاسخ جدید بر تیکت با شناسه ticketId
اضافه کنید.
آدرس وب سرویس
:ticketId
/metaپارامترها
نام | نوع | توضیحات |
---|---|---|
content | string | متن پیغام |
attachment | File | (اختیاری) فایل ارسالی در پیغام |
برای اطلاعات بیشتر به بخش آپلود فایل مراجعه کنید.
خروجی
شی Ticket ویرایش شده در خروجی ارسال میشود.
بستن تیکت
با کمک این سرویس میتوانید تیکت با شناسه ticketId
را ببندید.
آدرس وب سرویس
:ticketId
/closeپارامترها
بدون ورودی
خروجی
شی BooleanResponse در خروجی ارسال میشود.
Reference
در این قسمت میتوانید لیست کاملی از مواردی که در هر سرویس از API در دسترس دارید را ببینید.
این صفحه به شما کمک میکند خیلی سریعتر به لیست تمامی دستورات در هر سرویس دستیابی داشته باشید.
Account
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه اکانت |
identifier | string | شناسه منحصر اکانت |
name | string | نام اکانت |
login_required | integer | نیاز به ورود مجدد |
relogin_reason | string | شناسه اکانت |
date | string | تاریخ ثبت |
type | string | نام شبکه اجتماعی |
comment_subscribe | integer | اشتراک کامنت |
profile_url | string | لینک پروفایل اکانت |
info | string | توضیحات اکانت |
insights_order | integer | ترتیب آنالیز |
direct_subscribe | integer | اشتراک مکالمه |
AccountGroup
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه گروه اکانت |
name | string | نام گروه اکانت |
date | string | تاریخ ثبت |
account_ids | integer[] | شناسه اکانتها در گروه |
AccountPost
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه پست |
type | string | نوع پست ( text, image, album, video, link, document, story ) |
post_id | string | شناسه منحصر پست |
image | string | لینک تصویر |
content | string | محتوی پست |
date | string | تاریخ ثبت |
like_count | integer | تعداد لایک |
comment_count | integer | تعداد کامنت |
social_user_id | integer | شناسه کاربر ارسال کننده |
user_id | integer | شناسه کاربر |
account_id | integer | شناسه اکانت |
permalink | string | لینک پست |
social | string | شبکه اجتماعی پست |
BooleanResponse
نام | نوع | توضیحات |
---|---|---|
success | boolean | در صورت موفقیت بودن عملیات true است. |
Caption
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه کپشن |
name | string | نام کپشن |
caption | string | متن کپشن |
date | string | تاریخ ثبت |
Comment
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه کامنت |
comment_id | integer | شناسه منحصر کامنت |
text | string | متن کامنت |
date | string | تاریخ ثبت |
can_delete | integer | قابل حذف |
can_reply | integer | قابل پاسخ |
can_like | integer | قابل لایک |
status | integer | وضعیت |
like | integer | لایک |
post_id | string | شناسه پست |
parent_id | string | شناسه کامنت اصلی ( در صورت موجود ) |
social_user_id | integer | شناسه کاربر ارسال کننده |
account_id | integer | شناسه اکانت |
user_id | integer | شناسه کاربر |
social | string | شبکه اجتماعی پست |
from | integer | نام ارسال کننده ( در صورت ارسال از پنل ) |
tags | CommentTag[] | تگ های کامنت |
parentName | integer | نام ارسال کننده کامنت اصلی |
Field expansions
برای اطلاعات بیشتر به صفحه Field expansion مراجعه کنید
CommentTag
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه تگ |
name | string | نام تگ |
color | string | کد رنگ تگ |
user_id | integer | شناسه کاربر |
Conversation
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه مکالمه |
conversation_id | integer | شناسه منحصر مکالمه |
update_date | string | تاریخ آخرین تغییر |
participants | ConversationParticipant[] | کاربران مکالمه |
account_id | integer | شناسه اکانت |
last_message | string | متن آخرین پیغام |
last_seen_message_id | integer | شناسه آخرین پیغام دیده شده |
last_seen_time | string | تاریخ آخرین پیغام دیده شده |
tags | ConversationTag[] | تگ های مکالمه |
status | integer | وضعیت |
ConversationParticipant
نام | نوع | توضیحات |
---|---|---|
social_user_id | integer | شناسه کاربر |
socialUser | SocialUser[] | کاربر |
CursorPagination
نام | نوع | توضیحات |
---|---|---|
data | Object | لیست آیتمهای صفحه بندی |
paging | Array | آرایه صفحه بندی با اندیس های before، after و total |
Department
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه واحد |
name | string | نام واحد |
ErrorResponse
نام | نوع | توضیحات |
---|---|---|
message | string | متن خطا |
type | string | نوع خطا |
trace_id | string | شناسه پیگیری خطا |
File
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه فایل |
title | string | نام فایل |
filesize | integer | حجم فایل به بایت |
date | string | تاریخ ثبت |
url | string | لینک فایل |
thumbnailUrl | string | لینک پیش نمایش |
fileType | string | نوع فایل ( image, video, document ) |
ext | string | پسوند فایل |
GenerateImage
نام | نوع | توضیحات |
---|---|---|
image | string | فایل تولید شده به صورت base64 |
mime | string | نوع فایل |
Insights
نام | نوع | توضیحات |
---|---|---|
metric | string[] | نام داده |
data | integer|string|array|object | داده آنالیز |
InsightsResponse
نام | نوع | توضیحات |
---|---|---|
insights | Insights[] | آرایه از دادههای آنالیز |
metric | string[] | دادههای لود شده |
Message
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه پیام |
message_id | integer | شناسه منحصر مکالمه |
conversation_id | integer | شناسه مکالمه |
type | string | نوع پیام ( text, media, share, mention_story, reply_story, unsupported ) |
attachment | string | لینک فایل پیوست ( در صورت موجود ) |
text | string | متن پیغام |
date | string | تاریخ ثبت |
can_delete | integer | قابل حذف |
can_reaction | integer | قابل واکنش |
social_user_id | integer | شناسه کاربر ارسال کننده |
reactions | MessageReaction[] | واکنشهای پیام |
account_id | integer | شناسه اکانت |
MessageReaction
نام | نوع | توضیحات |
---|---|---|
social_user_id | integer | شناسه کاربر |
is_owner | boolean | در صورتی که صاحب اکانت باشد true است |
socialUser | SocialUser[] | کاربر |
Pagination
نام | نوع | توضیحات |
---|---|---|
data | Object | لیست آیتمهای صفحه بندی |
paging | Array | آرایه صفحه بندی با اندیسهای prev، next، page، total و totalPage |
Post
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه پست |
caption | string | متن |
media_ids | integer[] | شناسه های فایل |
account_id | integer | شناسه اکانت |
publish_date | string | تاریخ انتشار |
location | string | موقعیت مکانی |
status | string | وضعیت پست |
log | string | متن خطای پست |
PostGroup
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه گروه پست |
type | string | نوع پست |
is_scheduled | string | پست زمانبندی شده |
create_date | string | تاریخ ثبت |
schedule_date | string | تاریخ زمانبندی |
from_user | string | نام ارسال کننده ( در صورت ارسال از پنل ) |
caption | string | متن |
RedirectResponse
نام | نوع | توضیحات |
---|---|---|
redirect | string | آدرس صفحه که کاربر نیاز است به آن هدایت شود. |
SocialUser
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه کاربر |
username | string | نام کاربری |
name | string | نام کاربر |
image | string | تصویر پروفایل |
social | string | شبکه اجتماعی پست |
SearchLocation
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه موقعیت |
name | string | نام موقعیت |
description | string | توضیحات |
social | string | نام شبکه اجتماعی |
lat | string | مقدار latitude |
lng | string | مقدار longitude |
type | location | مقدار ثابت |
SearchPeople
نام | نوع | توضیحات |
---|---|---|
pk | integer | شناسه کاربر |
username | string | نام کاربری |
profile_pic_url | string | تصویر شبکه اجتماعی |
StorageInfo
نام | نوع | توضیحات |
---|---|---|
total_files | integer | تعداد کل فایل ها |
max_file_size | integer | سقف آپلود هر فایل |
max_file_size_readable | string | سقف آپلود هر فایل فرمت شده |
total_storage | integer | کل فضای موجود |
total_storage_readable | string | کل فضای موجود فرمت شده |
used_storage | integer | فضای استفاده شده |
used_storage_readable | string | فضای استفاده شده فرمت شده |
remaining_storage | integer | فضای باقی مانده |
remaining_storage_readable | string | فضای باقی مانده فرمت شده |
Ticket
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه تیکت |
title | string | عنوان تیکت |
status | integer | وضعیت |
date | string | تاریخ ثبت |
department_id | integer | واحد پشتیبانی |
status_name | string | وضعیت |
rate | integer | امتیاز |
TicketMeta
نام | نوع | توضیحات |
---|---|---|
id | integer | شناسه پیام |
content | string | متن پیام |
date | string | تاریخ ثبت |
ticket_id | integer | شناسه تیکت |
attachment | string | لینک پیوست ( در صورت موجود ) |
report | string | متن گزارش |
user | TicketUser | کاربر ارسال کننده |
TicketUser
نام | نوع | توضیحات |
---|---|---|
name | string | نام کاربر |
firstname | string | نام کاربر |
lastname | string | نام خانوادگی کاربر |
isAdmin | string | ادمین بودن کاربر |
User
نام | نوع | توضیحات |
---|---|---|
string | ایمیل | |
user_type | string | نوع کاربر ( real, legal ) |
natioanl_code | string | کد ملی ( در صورت حقیقی بودن ) |
company | string | نام شرکت ( در صورت حقوقی بودن ) |
national_id | string | شناسه ملی ( در صورت حقوقی بودن ) |
tax_number | string | کد اقتصادی ( در صورت حقوقی بودن ) |
registration_number | string | شماره ثبت ( در صورت حقوقی بودن ) |
mobile | string | شماره تماس |
name | string | نام |
package_id | integer | شناسه پکیج |
timezone | string | موقیت زمانی |
dateformat | string | فرمت تاریخ |
timeformat | string | فرمت ساعت |
language | string | زبان |
expire_date | string | تاریخ انقضا |
packageTitle | stringr | عنوان پکیج |
emailactive | string | فعال بودن ایمیل |
smsactivate | integer | فعال بودن پیامک |
has_webserivce | string | فعال بودن وب سرویس |
activity | string | فعالیت |
postal_code | string | کد پستی |
address | string | آدرس |