Opencart rest api: Opencart REST API extensions — RESTFUL services

OC API v1.x.x beta

• Описание
• Характеристики
• Отзывов (0)

OC API — универсальное решение для работы с интернет магазином на платформе OpenCart 3.х реализованное в виде модуля. API построен на REST-принципах, работает с реальными объектами и обладает предсказуемым поведением. С помощью этого API вы сможете проходить весь цикл покупки товара, от поиска до оформления и многое другое. Так же при использовании данного решения появится возможность на его основе создавать мобильное приложение для вашего интернет магазина. 

API в качестве основного протокола использует HTTP, а значит, подходит для разработки на любом языке программирования, который умеет работать с HTTP-библиотеками (cURL и другими). API поддерживает POST и GET-запросы. API всегда возвращает ответ в формате JSON, независимо от типа запроса.

Вдобавок к модулю сделал документацию. Она построена на фреймворке Swagger (OpenApi 3.0), Ознакомиться с ней можно тут или для тех кто любит потемнее тут. Документация далека от идеала, но это и неудивительно ведь это только BETA. В дальнейшем по мере возможности буду с ней работать. Все изменения будут отражены вкладке обновления или на сайте модуля. Да кстати! Для модуля сделал не большой одностраничник на котором можно также ознакомиться  с документацией, порядком установки и настройки.

Установки:

1. Создаем резервную копию вашего сайта. Важно!!! Скачиваем и распаковываем архив.

2. После распаковки находим архив с именем ocapi.ocmod.zip. Его устанавливаем через панель администратора на вашем сайте. Панель администратора -> Дополнения -> Установка. Обновляем модификаторы.

3. Находим файл .htaccess.txt. Открываем в любом удобном для вас блокноте. Копируем все содержимое. В корневой директории вашего сайта находим файл .htaccess. Открываем, находим строку RewriteBase / и вставляем все содержимое из файла .htaccess.txt после неё и сохраняем.

Настройка:

1. Находим модуль OC API и устанавливаем.

2. В настройнах, во вкладке «Основные» переводим переключатель поля «Статус» в положение Включено.

3. Во вкладке «Приложения», добавляем новое.

4. Во вкладке «Основные» вписываем «ID приложения», например «ios_app», генерируем «Ключ приложения» и переводим переключатель поля «Статус» в положение Включено.

5. Во вкладке «IP и Hosts», добавляем «IP» и/или «Host» с которого ваше приложение будет отправлять запросы. Например: «IP:127.0.0.1, Host: http://localhost:3001». Сохраняем.

Aутентификации:

Для аутентификации запросов необходимо использовать API Key. Вам потребуется «Ключ приложения» и «ID приложения» из настроек модуля в панели администратора. Во всех заголовках запросов в качестве App-Id, необходимо передать идентификатор вашего приложения (ID приложения) , в качестве Api-Key — ваш секретный ключ (Ключ приложения).

P.S. Жду конструктивной критики, замечаний и предложений по улучшению.

Обмен товарами по REST API Allegro.

pl и сайтом OpenCart за 10000 руб., заказчик Александр (Silvio_Dante) – Kwork

Необходимо произвести интеграцию польской площадки https://allegro.pl/ с сайтом на OpenCart через REST API, документация https://developer.allegro.pl/about/

Примеры уже реализованных проектов:
https://fastbox.su/
https://aredi.ru/
https://www.br39.ru/
http://allegroexpress.ru/

Требования:

— В карточке товара должна содержаться основная информация о товаре — заголовок, описание, характеристики/атрибуты (на русском языке — перевод). Изображения товара. Основная цена товара в рублях (конвертация цены из польского злотого в рубли). Возможность выбора количества товара для заказа. Стоимость доставки по Польше в рублях — тип доставки Na adres za pobraniem. Id товара (на allegro отображается в ссылке и в карточке товара). Имя/название продавца-магазина с возможностью посмотреть все товары, рейтинг продавца, остаток товара, количество покупок. Ориентировочная дата доставки товара на пункт самовывоза, пример: две недели от сегодняшней даты.

— Возможность настройки ценообразования, установка наценки.

— Возможность найти товар через поиск на сайте, по ссылке или id товара с allegro.

— Возможность настраивать обмен, определять категории в которых должны отображаться товары. Выбирать для обмена конкретных продавцов или товары, исключать продавцов или товары из обмена.

— Личный кабинет пользователя с отображением истории/информации о заказах

— ЧПУ, если возможно

Допустимый: до 30 000 ₽

Допустимый: до 30 000 ₽

Сейчас вы не можете опубликовать проект. Публикация проектов теперь доступна вам не чаще одного раза в неделю. Вы сможете опубликовать свой проект .

Почему?

Ранее вы разместили на бирже немало проектов, но не сделали по ним заказы. Каждый опубликованный проект требует у продавцов время на изучение и составление откликов. На отправку откликов продавцы тратят ценные коннекты.

Kwork старается создать надежную фриланс-платформу с главными принципами: доверие и ответственность. Проекты, в которых никогда не будет выбран исполнитель, снижают доверие продавцов к Kwork и фрилансу в целом.

Как считается показатель «нанято»?

«Нанято» — это количество заказов через биржу, деленное на количество размещенных на бирже проектов. Берется не более 30 последних опубликованных вами проектов.

Как снять ограничение?

Чаще выбирайте исполнителей на бирже. И это ограничение будет снято. Конечно, часть проектов может оставаться без заказов, но показатель «нанято» не должен быть критически низким.

Стоимость

Порядок оплаты

Целиком, когда заказ выполнен

Оплата берется сразу и поступает продавцу после того, как вы проверите и одобрите заказ.

По мере выполнения задач

Оплата берется частями и поступает продавцу после того, как вы проверите и одобрите каждую задачу.

Для этого разделите заказ на задачи.

Когда выбирать оплату целиком?

Если проект не сильно большой, и вы не хотите разбивать оплату на несколько задач. Фрилансер не получит оплату, пока работа не будет выполнена на 100%.

Когда выбирать оплату по задачам?

1. Если проект большой, и вам удобнее оплачивать его постепенно по мере готовности.
2. Если вы хотите убедиться, что исполнитель потянет проект. В любой момент вы сможете остановить работу, оплатив только выполненные задачи.

Задачи

Задачи

В названии задачи отразите: что, когда и в каком объеме будет выполнено.

Название задачи

Если заказ объемный и длительный, разделите его на задачи. Каждая задача включает в себя задание, которое выполняется и оплачивается отдельно.

Вы также сможете добавить задачи после старта заказа.

Общий срок заказа: 

версий Opencart REST API | Opencart REST API

ОпенКарт | what3words

Расширение OpenCart позволяет вам добавить поле на страницу оформления заказа, которое может принимать адреса из 3 слов и предоставлять результаты автозаполнения в качестве типа пользователя.

Минимальная поддерживаемая версия OpenCart : > 2.3.x до 3.0.x и 3.0.x до 4.0.x

2

Установка

Загрузите расширение OpenCart здесь.

Загрузите файл в свой магазин на портале администрирования OpenCart с помощью установщика расширений.

3

Включить плагин

После установки перейдите в раздел панели администратора Расширения > Расширения и в раскрывающемся списке выберите Модули , где вы должны увидеть расширение what3words . Нажмите на кнопку Edit , затем для включения модуля необходимо изменить статус модуля what3words на Enabled .

4

Добавьте свой ключ API

Для использования этого плагина вам понадобится ключ API what3words, так как он выполняет аутентификацию и взаимодействует с API what3words. Если у вас еще нет ключа API what3words, вы можете быстро и легко зарегистрироваться и получить его.

Если у вас есть ключ API what3words:

1. Введите свой ключ API в поле ключа API.
2. Нажмите Сохранить

5

Проверьте, отображается ли поле

Теперь новое поле должно появиться в вашей кассе в разделе «Выставление счетов и доставка». Когда в этом поле будет указан адрес what3words, он будет сохранен вместе с деталями вашего заказа и будет отображаться на экранах предварительного просмотра заказа и этикетки для доставки.

6

Как получить поле what3words с помощью Stores API

In OpenCart, the what3words address attributes are stored in the customers’ orders of the OpenCart Orders REST APIs as:

• shipping_three_word_address
• shipping_w3w_coordinatesLng when the save coordinates option is enabled
• shipping_w3w_coordinatesLat when опция сохранения координат включена
• shipping_w3w_nearestPlace при сохранении ближайшего места 9Опция 0332 включена

API-запрос к REST API OpenCart Orders должен быть:
GET {{your-opencart-site}}/index. php?route=api/order/info&api_token={{api_token} }&order_id={{order_id}}

Ответ API должен быть:

 {
   "заказ": {
       "идентификатор_заказа": "3",
       ...
       "shipping_three_word_address": "///filled.count.soap",
       "shipping_w3w_coordinatesLng": -0,195521,
"shipping_w3w_coordinatesLat": 51.520847,
       «shipping_w3w_nearestPlace»: Бэйсуотер, Лондон,
       ...
       "comment": "отправить на адрес w3w ///filled.count.soap",
       ...
} 

Скопировано

Сохранение координат

Если вам нужно сохранить координаты для адреса из трех слов, например, для помощи с информацией о доставке, вы должны установить флажок Сохранить координаты .

Координаты будут добавлены к вашему заказу и видны на вашей странице продаж в Opencart.

Примечание здесь используется дополнительный вызов API what3words для преобразования адреса what3words в координаты. Убедитесь, что уровень, на который вы подписались, покрывает объем использования, который вы собираетесь использовать, чтобы избежать прерывания обслуживания.

Сохранить ближайшее место

Если вам нужно записать информацию о ближайшем месте для адреса из трех слов, например, чтобы помочь с информацией о доставке, вы должны установить флажок Сохранить ближайшее место .

Информация о ближайших местах будет добавлена ​​к вашему заказу и будет отображаться на вашей странице продаж в Opencart.

Пользовательская метка

Вы можете переопределить метку по умолчанию для поля адреса, выбрав этот параметр и указав текст заполнителя. Мы рекомендуем вам использовать значение метки по умолчанию, так как оно дает вашим клиентам пример того, как использовать адресное поле what3words.

Пользовательский заполнитель

Вы можете переопределить заполнитель по умолчанию для поля адреса, выбрав этот параметр и указав текст заполнителя. Мы рекомендуем вам использовать значение заполнителя по умолчанию, так как оно предоставляет вашим клиентам пример того, как использовать адресное поле what3words.

Всплывающая подсказка

Чтобы помочь клиенту, вы можете отобразить всплывающую подсказку и значок вопросительного знака рядом с полем what3words.
Это сообщение будет отображаться в пояснительной подсказке:

Введя свой адрес из 3 слов, нашим партнерам по доставке будет намного проще найти вас в первый раз. Чтобы узнать свой адрес из трех слов, посетите сайт what3words.com.

Ограничение результатов поиска

Мы предоставляем несколько вариантов обрезки результатов автозаполнения, ограничивая адреса, которые можно проверить и захватить. Вы можете обрезать предложения для ряда стран, указав разделенные запятыми 2-значные коды ISO для каждой страны, которую вы хотите обрезать. Это гарантирует, что предоставленные предложения будут обрезаны в пределах указанных стран. Вы также можете обрезать круг, ограничивающую рамку или многоугольник.

N.B. – При предоставлении нескольких вырезок пересечение каждого полигона формирует предложения, предоставляемые при использовании адресного поля what3words.

Для большинства проверок мы рекомендуем пропускать эти параметры, так как привязка к стране автоматически устанавливается, когда пользователь выбирает страну для своей платежной информации и / или информации о доставке, когда он выбирает страну из параметров раскрывающегося меню в форме оформления заказа.