README

一个用于通过 ean-search.org 的 API 进行 EAN、UPC 和 ISBN 名称查找及验证的库。

安装

composer require lsv/ean-search

设置

要使用它，您需要从 ean-search 获取 API 访问令牌

然后您需要使用以下命令设置您的令牌

\Lsv\EanSearch\Request::setApiToken('<token>');

用法

在以下所有地方 <language> 都是从 \Lsv\EanSearch\Utils\LanguageEnum 中选择的语言

例如。

\Lsv\EanSearch\Utils\LanguageEnum::SPANISH

条形码查找

查询 ean-search 数据库中的特定条形码。

$response = \Lsv\EanSearch\BarcodeLookup::request('<barcode>', '<language>');
// Response is a \Lsv\EanSearch\Model\ProductModel object

条形码前缀搜索

查询 ean-search 数据库中所有以相同开头的条形码。

$response = \Lsv\EanSearch\BarcodePrefixSearch::request('<barcode prefix>', '<language>');
// Response is an array of \Lsv\EanSearch\Model\ProductModel objects

验证校验和

您可以在条形码中验证校验和。这允许您检查它是否是有效的条形码，无论 ean-search 是否在数据库中有记录。

$response = \Lsv\EanSearch\VerifyChecksum::request('<barcode>');
// Response is a \Lsv\EanSearch\Model\VerifyChecksumModel object

条形码图像

$response = \Lsv\EanSearch\BarcodeImage::request('<barcode>', '<width>', '<height>');
// <width> and <height> is optional
// Response is a \Lsv\EanSearch\Model\BarcodeImageModel object

发行国家查找

查询 ean-search 数据库中的条形码发行国家。

与条形码查找相比，即使我们不知道产品名称，这也会给出结果。

$response = \Lsv\EanSearch\IssuingCountryLookup::request('<barcode>');
// Response is a \Lsv\EanSearch\Model\IssuingCountryModel object

产品搜索

查询 ean-search 数据库中的关键词或产品名称。

$response = \Lsv\EanSearch\ProductSearch::request('<product name>', '<language>');
// Response is an array of \Lsv\EanSearch\Model\ProductModel objects

分类搜索

查询 ean-search 数据库中的特定分类的产品。

要获取 <category>，您必须使用 \Lsv\EanSearch\Utils\CategoryEnum

例如。

\Lsv\EanSearch\Utils\CategoryEnum::ART

$response = \Lsv\EanSearch\CategorySearch::request('<category>', '<product name>', '<language>');
// <product name> is optional
// Response is an array of \Lsv\EanSearch\Model\ProductModel objects

账户状态

查询您的账户状态。

$response = \Lsv\EanSearch\AccountStatus::request();
// Response is a \Lsv\EanSearch\Model\AccountStatusModel object

许可证

MIT 许可证

版权（c）2022 Martin Aarhof

特此授予任何获得本软件及其相关文档副本（“软件”）的人免费权利，可以在不受限制的情况下处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许将软件提供给其他人，以便他们可以进行上述操作，前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。

本软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、针对特定目的的适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论该责任是因合同、侵权或其他原因引起的，无论该责任是否与软件或其使用或其他方式有关。