اشنایی با پیام رسان گپ ومستندات api

shape
shape
shape
shape
shape
shape
shape
shape

در مقاله های قبل در مورد معرفی api پیام رسان گپ و ابزار های کاربردی گپ بااستفاده از api توضیح دادیم در این مقاله در مورد اشنایی با پیام رسان گپ ومستندات api توضیح میدهیم.

اطلاعات، خدمات، بازی و سرگرمی

پیام رسان گپ؛ دنیایی از اطلاعات کاربردی، خدمات مفید، بازی و سرگرمی را در اختیار شما قرار می‌دهد. در پیام رسان گپ می‌توانید محتوا یا موضوع موردنظر خود را انتخاب کرده و لذت دسترسی سریع و آسان به اطلاعات دلخواه را تجربه کنید. در بازی‌های آنلاین گپ با دوستان خود رقابت کنید و آن‌ها را به چالش بکشید.

اطلاعات، خدمات، بازی و سرگرمی

پیام رسان گپ؛ دنیایی از اطلاعات کاربردی، خدمات مفید، بازی و سرگرمی را در اختیار شما قرار می‌دهد. در پیام رسان گپ می‌توانید محتوا یا موضوع موردنظر خود را انتخاب کرده و لذت دسترسی سریع و آسان به اطلاعات دلخواه را تجربه کنید. در بازی‌های آنلاین گپ با دوستان خود رقابت کنید و آن‌ها را به چالش بکشید .

 

بات پلتفرم

پیام رسان گپ یک بستر مدرن ارتباطی را در اختیار توسعه دهندگان قرار می دهد تا بتوانند بر پایه گپ خدمات، محصولات و محتوای مورد نظر خودشان را به صورت ساده و تعاملی در اختیار مشترکین گپ قرار دهند. توسعه دهندگان می توانند این خدمات و محتوا را به صورت رایگان در اختیار مشترکین قرار دهند و یا کسب درآمد نمایند.

 

کسب درآمد

پیام‌رسان گپ دنیایی از امکانات کاربردی و خدمات حوزه بازی و سرگرمی در اختیار شما قرار می‌دهد. در پیام رسان گپ شما به راحتی می‌توانید فروشگاه مجازی خود را راه اندازی و شروع به فروش محصولات و خدمات خود کنید. نگران پرداخت هزینه نباشید چرا که کیف پول گپ همیشه در کنار شماست تا با آسودگی خاطر از درگاهی امن برای مدیریت مالی سرویس ها و فروشگاه‌های خود استفاده کنید.

 

کیف پول همراه شما

شما با استفاده از کیف پول گپ می‌توانید حساب خود را شارژ کنید و پرداخت‌های مختلفی را انجام دهید. خرید از فروشگاه‌ها، شرکت در جشنواره‌ها و مسابقات، استفاده از امکانات خاصی از بازی‌ها و صدها امکان دیگر همگی در کیف پول همراه شما قرار گرفته است.

ارسال و درخواست وجه

درخواست پول در بستر گپ، شما می توانید با استفاده از این امکان در گپ صورتحساب ایجاد کنید و برای دوستان و خانواده بفرستید. از موارد مورد استفاده از این سرویس می توان به دریافت دانگ، یاداوری و دریافت قسط در قرض‌الحسنه های خانوادگی، پرداخت شارژ ساختمان. فعالیت‌های نیکوکارای و … اشاره کرد.

مستندات api

ارسال تصویر (Image)

برای ارسال تصویر ابتدا باید آن را از طریق متود ارسال فایل به کاربر آپلود کنید و سپس از این متود برای ارسال به کاربر استفاده کنید.

POST https://api.gap.im/sendMessage
نام داده نوع الزامی توضیحات
chat_id integer بلی شناسه منحصربفرد کاربر که در هنگام عضویت در سرویس و یا ارسال پیام برای توسعه دهنده ارسال شده است. البته با در اختیار داشتن شماره موبایل کاربر که عضو سرویس شما می‌باشد می‌توانید در این فیلد بجای chat_id شماره موبایل کاربر را با فرمت 989123456789+ وارد کنید.
type string بلی نوع داده که باید روی image تنظیم شود.
data string بلی این مقدار برابر با آرایه‌ای است که پس از ارسال فایل به کاربر دریافت می‌کنید.
reply_keyboard string خیر افزودن کیبورد از نوع Reply Keyboard به پیام. این آرایه باید به صورت encode شده ارسال شود
inline_keyboard string خیر افزودن کیبورد از نوع Inline Button به پیام. این آرایه باید به صورت encode شده ارسال شود

بطور مثال مقدار دریافتی پس از آپلود فایل باید مشابه آرایه ذیل باشد و شما باید این مقدار دریافتی از متود ارسال فایل به کاربر را در قسمت data ارسال کنید.

{
“screenshots”: {
“64”: “https://domain.com/7986bc684c-5eh469san2sab81e008t4755.png”,
“128”: “https://domain.com/cf7ed93c6a-5eh469san2sab81e008t4755.png”,
“256”: “https://domain.com/fae9add40d-5eh469san2sab81e008t4755.png”,
“512”: “https://domain.com/f8992c8fc3-5eh469san2sab81e008t4755.png”
},
“type”: “image”,
“path”: “https://domain.com/0bd8afdf1b-5eh469san2sab81e008t4755.png”,
“width”: 512,
“height”: 512,
“filesize”: 412727,
“filename”: “image.png”
}

200 Success Request
توضیحات پارامتر
id شناسه پیام ارسالی شما . در واقع همان message_id می باشد .

Error 400 Bad Request
توضیحات پارامتر
chat_id داده ارسالی معتبر نمی‌باشد.
data داده ارسالی معتبر نمی‌باشد.
reply_keyboard داده ارسالی معتبر نمی‌باشد.
inline_keyboard داده ارسالی معتبر نمی‌باشد.

همچنین شما می‌توانید در صورت لزوم به این آرایه یک مشخه با نام desc هم اضافه کنید که به عنوان توضیحات یا caption در نظر گرفته می‌شود.

ارسال فایل صوتی (Audio)

برای ارسال فایل صوتی ابتدا باید آن را از طریق متود ارسال فایل به کاربر آپلود کنید و سپس از این متود برای ارسال به کاربر استفاده کنید.

POST https://api.gap.im/sendMessage
نام داده نوع الزامی توضیحات
chat_id integer بلی شناسه منحصربفرد کاربر که در هنگام عضویت در سرویس و یا ارسال پیام برای توسعه دهنده ارسال شده است. البته با در اختیار داشتن شماره موبایل کاربر که عضو سرویس شما می‌باشد می‌توانید در این فیلد بجای chat_id شماره موبایل کاربر را با فرمت 989123456789+ وارد کنید.
type string بلی نوع داده که باید روی audio تنظیم شود.
data string بلی این مقدار برابر با آرایه‌ای است که پس از ارسال فایل به کاربر دریافت می‌کنید.
reply_keyboard string خیر افزودن کیبورد از نوع Reply Keyboard به پیام. این آرایه باید به صورت encode شده ارسال شود
inline_keyboard string خیر افزودن کیبورد از نوع Inline Button به پیام. این آرایه باید به صورت encode شده ارسال شود

بطور مثال مقدار دریافتی پس از آپلود فایل باید مشابه آرایه ذیل باشد، و شما باید این مقدار دریافتی از متود ارسال فایل به کاربر را در قسمت data ارسال کنید.

{
“type”: “audio”,
“path”: “https://domain.com/e679f7495d-5acaed60e2hsa87n008b4937.mp3”,
“tags”: {
“genre”: “Audio genre”,
“album”: “Album name”,
“artist”: “Artist name”,
“title”: “Audio title”,
“cover”: “https://domain.com/825fd59059-5acaed60c2ehs87a008n4937.jpg”,
“filename”: “audio.mp3”
},
“duration”: 237.51892,
“filesize”: 5700454,
“filename”: “audio.mp3”
}

همچنین شما می‌توانید در صورت لزوم به این آرایه یک مشخه با نام desc هم اضافه کنید که به عنوان توضیحات یا caption در نظر گرفته می‌شود.

200 Success Request
توضیحات پارامتر
id شناسه پیام ارسالی شما . در واقع همان message_id می باشد .

Error 400 Bad Request
توضیحات پارامتر
chat_id داده ارسالی معتبر نمی‌باشد.
data داده ارسالی معتبر نمی‌باشد.
reply_keyboard داده ارسالی معتبر نمی‌باشد.
inline_keyboard داده ارسالی معتبر نمی‌باشد.

ارسال ویدئو (Video)

برای ارسال ویدئو ابتدا باید آن را از طریق متود ارسال فایل به کاربر آپلود کنید و سپس از این متود برای ارسال به کاربر استفاده کنید.

POST https://api.gap.im/sendMessage
نام داده نوع الزامی توضیحات
chat_id integer بلی شناسه منحصربفرد کاربر که در هنگام عضویت در سرویس و یا ارسال پیام برای توسعه دهنده ارسال شده است. البته با در اختیار داشتن شماره موبایل کاربر که عضو سرویس شما می‌باشد می‌توانید در این فیلد بجای chat_id شماره موبایل کاربر را با فرمت 989123456789+ وارد کنید.
type string بلی نوع داده که باید روی video تنظیم شود.
data string بلی این مقدار برابر با آرایه‌ای است که پس از ارسال فایل به کاربر دریافت می‌کنید.
reply_keyboard string خیر افزودن کیبورد از نوع Reply Keyboard به پیام. این آرایه باید به صورت encode شده ارسال شود
inline_keyboard string خیر افزودن کیبورد از نوع Inline Button به پیام. این آرایه باید به صورت encode شده ارسال شود

بطور مثال مقدار دریافتی پس از آپلود فایل باید مشابه آرایه ذیل باشد، و شما باید این مقدار دریافتی از متود ارسال فایل به کاربر را در قسمت data ارسال کنید.

{
“screenshots”: {
“64”: “https://domain.com/56cb3f5f4d-5e9h62san2sab875348e4576.mp4.jpg”,
“128”: “https://domain.com/9fcc0b820c-5e9h62san2sab875348e4576.mp4.jpg”,
“256”: “https://domain.com/c90333989e-5e9h62san2sab875348e4576.mp4.jpg”,
“512”: “https://domain.com/e5bbb66ac3-5e9h62san2sab875348e4576.mp4.jpg”
},
“type”: “video”,
“path”: “https://domain.com/79cf7ab524-5e9h62san2sab875348e4576.mp4”,
“width”: 640,
“height”: 360,
“duration”: 95.232,
“filesize”: 3061490,
“filename”: “video.mp4”
}

همچنین شما می‌توانید در صورت لزوم به این آرایه یک مشخه با نام desc هم اضافه کنید که به عنوان توضیحات یا caption در نظر گرفته می‌شود.

سایر مستندات api واطلاعات کامل تر در سایت گپ موجود است که شما می توانید جهت اشنایی با پیام رسان گپ ومستندات api به نرم افزار گپ مراجعه نمائید

 

منبع

 

دیدگاهتان را بنویسید

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