ایوند - Evand API

سلام سرویس اصلی ایوند نیاز به ورودیه ای داره که بتونه رویدادهای ویژه کاربران رو از سرویس مربوطه ای دریافت بکنه. این اطلاعات همانطوری که تحویل گرفته می شه، برای استفاده های بعدی در جدول user_special_event ذخیره می شوند. برای تحویل رویدادها بدین شکل عمل می کنیم: POST http://api.evand.com/ data-providers/user-special-events Headers: Authorization: Bearer TOKEN [ { "user_id": 1, "events": [ [1, 1], [2, 0.9], [100, 0.8] ] }, { "user_id": 2, "events": [ [1, 1], [2, 0.9], [100, 0.8] ] } ] چند نکته، یک اینکه برای اینکه بتونید درخواستی ثبت کنید نیاز به اهراز هویت است و نیاز است توکن jwt تان رو از هدر ارسال نمایید. کاربر تان نیازه که دسترسی ادمین داشته باشه. دیتاهای ارسالی نیاز است بصورت آرایه ارسال شود. می تونید رویدادهایی که مربوط به یه کاربر است رو در یه درخواست جدا ارسال کنید و یا اطلاعات چندین کاربر رو همزمان ارسال کنید. هر کدام که راحت هستید قابل انجام است. اطلاعات رویدادهایی که برای یه کاربر می فرستید، ب

رویدادهای امکان ارسال نظرسنجی برای شرکت کننده گانشان را دارا می باشند. از طرفی راهی برای پاسخگویی به سوالات نظرسنجی نیاز است. هدف این مطلب توضیح، نحوه پاسخ گویی به سوالات نظرسنجی ارسال شده به شرکت کننده می باشد. برای پاسخ گویی نیاز به کد بلیت، آی دی نظرسنجی و  آی دی سوال (ها) همراه با پاسخ شان وجود دارد که نیاز است بصورت کتبی تحویل ریسورس مورد نظر شود. برای ثبت پاسخ های نظرسنجی به این شیوه عمل می کنیم: POST https://api.evand.com/surveys/ SURVEY_ID /answers { "attendee_id": " TICKET_CODE ", "questions": [ { "id": 1, "answer": ["no", "hello"] }, { "id": 2, "answer": "yes" }, { "id": 3, "answer": ["yes"] } ] } همونطور که ملاحظه می کنید، آی دی نظرسنجی (SURVEY_ID) در URI ریسورس تعیین شده است. یعنی نیازه که قرار بگیره. کد بلیت شرکت کننده (TICKET_CODE) هم در بدنه درخواست

قرار بر این است که تا ۴ رویدادی که کاربر عضو طی ۲ هفته گذشته بازدید کرده است را بصورت لیست در آورده و تقدیم حضورشان کنیم. این لیست قابلیت خالی بودن را دارا می باشد. حداکثر آیتم های موجود در این لیست ۴ تا خواهد بود ولی کمتر از این هم می تواند باشد. یعنی ۳، ۲، ۱، و هیچی. رویدادهای بازدید شده مربوط به کاربر عضو ایوند می باشد. در نتیجه نیاز است که توکن کاربر رو از طریق هدر برای ریسورس مربوطه ارسال نمایید. دریافت لیست برای دریافت لیست بدین صورت عمل می کنیم: GET https://api.evand.com/ recently-visited-events Headers: Authorization: Bearer TOKEN {     "data": [         {             "name": "event name",             "slug": "event_slug",             "city_name": "تهران",             "online": false,             "organization_name": "org name",             "organization_slug": "org_slug",             "start_date": "

درود کار این ریسورس بر این اساسه که کمپین ای برای عده مشخصی از افراد اجرا شود. ابتدا کمپین هایی در sendinblue تعریف، سپس برای اجرا شدن شان می توان با استفاده از همین ریسورس تعریف شده، که در زیر به شرحش خواهیم پرداخت استفاده نمود. اجرای کمپین برای اجرای کمپین ای، درخواستی بدین شکل به ریسورس مورد نظر ارسال می کنیم: POST https://api.evand.com/sib/runner/campaigns/ CAMPAIGN_NAME Headers:  Authorization: Bearer ACCESS_TOKEN [ {            "email": "email2@address.com”,             “eventdata” : […],            “properties” : […]         },         {            "email": "email1@address.com”,            “eventdata” : […],            “properties” : […]         },         ... ] نکات مهم زندگی : برای استفاده از این ریسورس نیاز به داشتن دسترسی دارید. در صورتی که دسترسی کافی را دارید، می توانید توکن خود را از طریق هدر Authorization ارسال نمایید. در URI ریسورس فوق، نیاز است اسم کمپین را

بعد از اجرای کمپین ای، برای دریافت آمار بازدید مربوط به کمپین اجرا شده، می شه به طریق ای که در زیر توضیح داده می شه، بدست آورد: قابلیتی که این ریسورس داره اینه که می شه در لینک مربوط به رویداد جست و جو کرد. در اصل وقتی کمپین ای اجرا می شه، موارد یکتایی در لینک رویداد مثل utm و امثالش اضافه می شه. که با جست و جوی این موارد می شه به تعداد بازدید مربوطه دست پیدا کرد. برای دریافت تعداد بازدید به این شکل عمل می کنیم: GET https://api.evand.com/statistics/total-event-page-visits { "total": 0, "since_last_x_days": 30 } در این مثال هیچ پارامتری به ریسورس مورد نظر داده نشده است و اتفاقی که می افته اینه که بصورت پیش فرض کل فروش ۳۰ روز گذشته رو بر می گردونه. فید total تعداد کل بازدید رو می گه. فید since_last_x_days هم باعث می شه آمار مربوط به تعداد روزهای تعیین شده، لحاظ بشه. پارامتر های ورود که این ریسورس می گیره به این شرح است: پارامتر query که هم می تونه متن باشه و یا آرایه ای از متن ها. مقدار query هم اگه لیستی از متن باشه، چک می شه این

هدف در آوردن تعداد فروش بلیت بر اساس یه سری ورودی هست. ممکنه کمپینی اجرا شده باشه، که در نهایت لینک رویدادی که دارای utm و موارد این چنینی در لینک گنجانده شده است به دست کاربر می رسد. از این طریق ممکنه فروشی رخ بده و کاربر مورد نظر اقدام به خرید بلیتی کند. هدف در آوردن تعداد این گروه از شرکت کنندگان است. برای دریافت تعداد فروش به این شکل عمل می کنیم: GET https://api.evand.com/statistics/total-sold-tickets { "total": 0, "since_last_x_days": 30 } در این مثال هیچ پارامتری به ریسور مورد نظر داده نشده است و اتفاقی که می افته اینه که بصورت پیش فرض کل فروش ۳۰ روز گذشته رو بر می گردونه. البته توجه کنید که یه سری فیلتر هایی روی داده های مورد نظر انجام می شه. به عنوان مثال کاربر قبل از خرید حتما باید از صفحه رویداد بازدید کرده باشه. که البته طبیعتا همه بازدید می کنن مگر اینکه دیتاش به هر دلیلی تو سیستم ثبت نشده باشه. فید total تعداد کل فروش بلیت رو می گه. فید since_last_x_days هم تعداد روزهای گذشته که از دیتاهاشون استفاده می شه. روزهای قبلت

سلام فید زنده شامل ۲ بخش ثبت پیام و خواندن پیام های ثبت شده می باشد. البته ممکنه حذف پیام رو هم اضافه کنیم. ثبت پیام برای ارسال و ثبت پیام در فید زنده، درخواستی بدین منظور ارسال می نماییم: POST https://connect.evand.com/api/ livefeed/messages Headers: Authorization: Bearer ACCESS_TOKEN Content-Type: application/json { " message ": "your message goes here" } همین. توجه کنید که ارسال فیلد message ضروری است و در صورت ارسال نشدنش خطای ۵۰۰ خواهید گرفت. در صورت موفقیت آمیز بودن قضیه کد ۲۰۴ برگشت داده می شه. در صورت نبود دسترسی کافی کد ۴۰۱ برگشت داده خواهد شد. برای اجتناب از این قضیه نیاز است توکن مربوط به کاربر لاگین شده رو به این ریسورس ارسال نمایید. این ریسورس هیچ اطلاعاتی برگشت نمی ده. مشاهده پیام ها برای مشاهده پیام های ثبت شده در فید زنده، درخواستی بدین صورت ارسال می نماییم: GET https://connect.evand.com/api/ livefeed/messages Headers: Authorization: Bearer ACCESS_TOKEN {   "_total_items": 11