dragu/php-allegroapi

一个用于与 Allegro Api 通信的最新库。该库采用面向对象设计,经过良好测试,易于使用。让你的工作更加愉快。该版本已与 PHP5.5 进行测试

dev-master 2016-05-14 13:54 UTC

This package is auto-updated.

Last update: 2024-09-25 01:28:52 UTC


README

一个用于与 Allegro Api 通信的最新库。该库采用面向对象设计,经过良好测试,易于使用。让你的工作更加愉快。该版本已与 PHP5.5 进行测试

文档

在本节中,我描述了您应该使用的类和方法

配置

要运行测试,您必须将您的登录名、密码和 appkey 插入到 Config/config.ini 文件中。

login = "Insert your login here"
hashPassword = "Insert your password's hash here - NEVER do it in production"
apikey = "Insert your apikey here"
sandbox = false
countryCode = 1

此文件仅用于测试。

您可以通过 http://allegro.pl/myaccount/webapi.php/ 页面创建您的访问数据。 sandbox 用于切换 allegro 沙盒和生产版本。 countryCode 用于选择当前国家。默认值为 1 表示 波兰。如果您想与其他 allegroGroup 服务(如:aukro.cz、molotok.ru、aukro.ua、teszvesz.hu)通信,可以更改国家。

安全

永远不要存储您的明文密码。您的应用程序应该始终通过 sha256(由 allegro 使用)对其进行哈希处理

  $hashPassword = base64_encode(hash('sha256', YOUR_ALLEGRO_PASSWORD, true));

类 AllegroApi

AllegroApi 是主类。提供 API 访问接口。

构造函数

需要 一个包含登录名、hashPassword(或密码 - 强烈不推荐)、apikey、sandbox、countryCode 字段的对象。这些数据用于初始化连接。

LoginEnc

登录到 allegro(使用构造函数数据)

运行函数

API 使用 _call 将函数名称映射到 allegro 请求。您应该使用不带 "do" 的简短名称。使用 getCountries(运行 allegro doGetCountries 函数)。

  $allegroApi = new AllegroApi($login, $hashPassword, $apiKey, $sandbox, $countryCode);
  $countrisResponse = $allegroApi->getCountries();

Allegro 函数文档

快速入门

克隆空项目

git clone https://github.com/SebastianPozoga/PHP-AllegroApi-EmptyProject.git
composer install

然后运行

php index.php

测试

通过以下方式运行测试

phpunit tests/AllegroApiTest

旧版本

强烈建议使用 PHP Allegro Api 库的新版本。如果您必须使用旧版本,可以在 https://github.com/SebastianPozoga/Allegro-PHP-API-14 上找到