Download the PHP package express-ru/sdk without Composer
On this page you can find all versions of the php package express-ru/sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package sdk
Экспресс Точка Ру - курьерская служба доставки документов и грузов по России и миру.
Подробнее об услугах нашей компании можно узнать на странице http://www.express.ru/services.
Ниже представлен комплект SDK, который поможет Вам использовать сервисы нашей компании еще более гибко. При возникновении вопросов, обращайтесь по адресам:
- вопросы касающиеся услуг компании и заказов - [email protected]
- вопросы касающиеся SDK - [email protected]
Использование Express.Ru SDK
NB: Из-за особенностей реализации API названия стран должны записываться в верхнем регистре (например РОССИЯ).
Установка
Через composer
Либо скопируйте файлы SDK в ваш проект сохраняя структуру файлов, например и подключите файл который зарегистрирует автозагрузчик классов SDK.
Конфигурация
Пользователь
Файл ExpressRuSDK\UserConfig.php
Настройки
Файл ExpressRuSDK\Config.php
Объект этого класса будет возвращаться из методов SDK. Класс должен реализовывать интерфейс
Свойства заказа по умолчанию
При создании объекта заказа класса ему будут присвоены свойства прописанные в классе . Если необходимо получать эти свойства из другого источника, то обратитесь к разделу Провайдеры кофигураций
Работа с SDK
Получение объекта нового заказа
Получение заказа с предустановленными значениями по умолчанию
При создании сущности заказа класса используя оператор с присвоением значений свойств по умолчанию необходимо вызвать метод в который будет передан объект реализующий интерфейс
Использование своего класса заказа
Вы можете использовать объекты заказа собственного класса, при условии реализации ими интерфейса
Расчет стоимости заказа
Создание заказа
Получение данных заказа
Получение истории заказов
Получение статусов заказа
Получение PDF накладной и сохранение на диск
Исключения
В случае нештатных ситуаций методы SDK пробрасывают следующие исключения. Объекты исключений содержат метод возвращающий объект
- Исключения наследующие .
-
- не получен ответ от API
-
- получен не валидный JSON
-
- структура ответа не соответствует ожидаемой
-
- в ответе API присутствует ошибка
-
-
- выбрасывается в случае если создаваемая сущность не прошла валидацию на стороне API. Содержит метод возвращающий массив ошибок.
Провайдеры кофигураций
По умолчанию объект SDK создается со следующими провайдерами конфигурации и которые получают значения из классов и соответственно. Если есть необходимость получать конфигурации из других хранилищ, то при созданиии объекта SDK в конструктор передаются провайдеры реализующие и
Использовать собственный провайдер конфигурации заказа можно и при создании его объекта с помощью оператора . Это касается объекта заказа класса . Подобный механизм можно реализовать используя собственный класс заказа.
Работа с запросами и ответами API напрямую
Помимо использования сущностей и репозиториев SDK возможна работа с ответами API напрямую. Возвращает объекты классов унаследованных от
Расчет стоимости заказа
Создание заказа
Получение данных заказа
Получение истории заказов
Получение статусов заказа
Получение PDF накладной
Express Tochka Ru-在俄罗斯及全世界范围内提供文件与货物快递服务。
可在http://www.express.ru/services网站中了解本公司服务的详细内容。
下面为大家介绍SDK集合,它可帮助您更灵活地使用我公司的服务。 如有疑问,请联系以下电子邮箱:
- 有关公司服务和订单问题[email protected]
- 有关SDK的问题- [email protected]
Express.Ru SDK的使用
NB: 由于API实现的特性,国家名称要标注在上方注册表中(例如 俄罗斯)。
安装
通过composer
或将SDK文件复制到您的项目中,同时保留文件的结构,如 ,接通对SDK等级自动装载器进行注册的文件。
配置
用户
ExpressRuSDK\UserConfig.php文件
设置
ExpressRuSDK\UserConfig.php文件
SDK方法论中的该等级对象将被还原。等级应实现接口
订单的默认性能
在建立等级订单对象 时,将授予它 等级中指定的性能。如果需要从其他来源中获得该性能,则请联系配置提供方一栏
SDK的操作
新订单对象的获取
获取带有设定默认值的订单
在建立等级订单实体时,在使用包含有默认值性能的操作器情况下,必须提出方法论,将已实现的接口对象传递到该方法论中。
订单固有等级的使用
在实现接口条件下,您可使用固有等级订单对象。
订单的价格计算
建立订单
订单数据获取
订单历史获取
订单状态获取
获得PDF提货单并保存在磁盘中
特殊情况
在出现意外情况时,SDK 方法论会漏掉以下意外情况。 意外对象包含方法论 还原对象
- 以下意外
- -未获得API回应
- -得到错误的JSON
-
- 回应结构与期待不符
-
- API响应中存在错误
- -当所建立的实体在API方面出现错误时跳出。 方法论包含 错误的还原数组。
配置提供方
建立的 默认对象带有以下配置提供方和,它们从 等级中获得相应的数值。 如果可能从其他存储器中获得配置,则在创建 对象时将所实现的和提供方发送至构造函数中
在借助操作器创建起对象的条件下,可使用订单配置的原有提供方。这与等级订单对象有关。该结构可在使用订单原有等级时实现。
直接实现API询问和回应
除使用SDK实体和软件源外,还可以与API进行直接回应。 从中还原沿用等级对象
订单的价格计算
建立订单
订单数据获取
订单历史获取
订单状态获取
获取PDF提货单
All versions of sdk with dependencies
ext-curl Version *