halva.4.12.md

Резюме конференции 4 декабря 2015.

Перечень доработок по API для реализации 1 этапа.

Товары

1. Исправить некорректный вывод в поле logo_path для запроса GET v2/merchants/products.
2. Загрузить изображения для 4-6 продуктов в начале выдачи для запроса GET v2/merchants/products.
3. Добавить поля подробного описания товара и условий получения в формате html, markdown или текстовом для запроса GET v2/merchants/products. В случае использования формата html рекомендуется ограничить код использованием тегов <strong>, <em>, <p>, <ul>, <ol>, <li>, <a>, <img> и запретить использование атрибутов тегов, кроме title, href, src и alt для ссылок и изображений.
4. Добавить в вывод дополнительные изображения товара. Рекомендуемые форматы:

"images": [
    "image1.jpg",
    "image2.jpg",
    ...
],

или

"images": [
    {
        "path": "image1.jpg",
        "title": "Image title"
    },
    {
        "path": "image2.jpg",
        "title": "Image title"
    },
    ...
]

Партнеры

1. Добавить поле описания деятельности (например, "Оператор сотовой связи") для запроса GET v2/merchants.
2. Добавить запрос на получение данных по одному партнеру GET v2/merchants/{id}.
3. Добавить поле "цвет фона" для отображения блоков логотипов. Рекомендуется использовать для вывода массив RGB значений ([122, 123, 124]) или RGB HEX (AABBCC).
4. Добавить поле "тип партнера" со значениями "онлайн" или "в магазине", а также возможность фильтрации выдачи по типу.
5. Добавить поле с кратким указанием выгоды для клиента, например "2 бонуса за 100 тенге"
6. Добавить поле "веб-сайт партнера". Рекомендуется использовать полный URI вместе с протоколом, например http://example.com
7. Добавить поля "как потратить бонусы" и "как получить бонусы". По дизайну в данных полях предусмотрены списки, поэтому возможно использовать как текст с разделением символом переноса строки \n, так и массивы значений.
8. Добавить в вывод дополнительные изображения аналогично товарам.
9. Добавить информацию по контактам (магазинам) с указанием номеров телефонов (не обязательно) и адресов с координанами для запроса GET v2/merchants/{id}. Рекомендуемый формат:

"shops": [
    {
        "address": "Алматы, пр. Абая, 100",
        "coordinates": [12.004, 14.555],
        "phones": ["+7 (727) 333-44-55", "+7 (727) 555-66-77"],
    },
    {
        "address": "Алматы, пр. Абая, 105",
        "coordinates": [12.777, 14.666],
        "phones": ["+7 (727) 333-55-44"],
    },
    ...
]

Вопросы-ответы

1. Проработать функционал отправки запросов в Omnidesk

Перечень изменений по API для реализации этапа 2 (предварительный)

1. Для акций добавить поля описания, заголовка, а также фильтры по датам и по источнику (Halva/партнеры) в запросе GET v2/merchants/allcampaigns.
2. Исправить запрос на создание транзакции: исключить необходимость передавать логин и пароль партнера POST v2/members/{id}/transactions.
3. Добавить фильтры по коду категории и режиму покупки (онлайн/магазин) для товаров в запросе GET v2/merchants/products.
4. Добавить фильтры по коду категории и режиму покупки (онлайн/магазин) для партнеров в запросе GET v2/merchants.
5. Добавить метод для получения списка категорий GET v2/categories.
6. Реализовать функционал "Бонусы бесплатно".
7. Реализовать функционал "Моя активность".
8. Реализовать функционал определения статусов (серебряный, золотой и т. д.).
9. Реализовать функционал "Моя семья".
10. Реализовать функционал "Мои купоны".