PHPackages                             amadulhaque/laravel-1688-package - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. amadulhaque/laravel-1688-package

ActiveLibrary[API Development](/categories/api)

amadulhaque/laravel-1688-package
================================

Alibaba 1688 API integration for Laravel

1.0.0(8mo ago)12MITPHPPHP ^8.2

Since Aug 23Pushed 8mo agoCompare

[ Source](https://github.com/AmadulHaque/laravel-1688-package)[ Packagist](https://packagist.org/packages/amadulhaque/laravel-1688-package)[ RSS](/packages/amadulhaque-laravel-1688-package/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (6)Versions (2)Used By (0)

1688-laravel
============

[](#1688-laravel)

A complete Laravel package for 1688 Alibaba. This package provides a simple and expressive API for interacting with the 1688.com dropshipping API.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require amadulhaque/laravel-1688-package
```

Next, you must publish the configuration file:

```
php artisan vendor:publish --provider="Amadulhaque\Laravel1688\Alibaba1688ServiceProvider" --tag="alibaba1688-config"
```

This will create a `config/alibaba1688.php` file in your project.

Finally, add the following keys to your `.env` file:

```
ALIBABA_APP_KEY=your-app-key
ALIBABA_SECRET_KEY=your-secret-key
ALIBABA_ACCESS_TOKEN=your-access-token

```

Usage
-----

[](#usage)

You can use the `Alibaba1688` facade to access the API methods.

### Search Products

[](#search-products)

```
use Amadulhaque\Laravel1688\Facades\Alibaba1688;

$products = Alibaba1688::products('iphone');
```

You can also provide additional parameters:

```
$products = Alibaba1688::products(
    keyword: 'iphone',
    currentPage: 1,
    pageSize: 20,
    priceStart: '100',
    priceEnd: '500',
    categoryId: 123
);
```

### Search Products by Multiple Keywords

[](#search-products-by-multiple-keywords)

```
$products = Alibaba1688::productsByMultipleKeywords(['hot items', 'new items']);
```

### Get Product Details

[](#get-product-details)

```
$productDetails = Alibaba1688::productDetails('product-id');
```

### Search by Image

[](#search-by-image)

```
$imageBase64 = base64_encode(file_get_contents('path/to/your/image.jpg'));
$products = Alibaba1688::productImageSearch($imageBase64);
```

### Get Recommended Products

[](#get-recommended-products)

```
$recommendedProducts = Alibaba1688::recommendProducts('product-id');
```

### Get Categories

[](#get-categories)

```
$categories = Alibaba1688::categories();
```

### Check Connection

[](#check-connection)

You can check the connection to the API:

```
$response = Alibaba1688::checkConnect();
```

Testing the Package
===================

[](#testing-the-package)

This document provides instructions on how to set up the environment and run the tests for this package.

Setup
-----

[](#setup)

1. **Clone the repository:**

    ```
    git clone https://github.com/AmadulHaque/1688-laravel.git
    cd 1688-laravel-package
    ```
2. **Install dependencies:**Make sure you have [Composer](https://getcomposer.org/) installed. Then, run the following command to install the required dependencies, including the development dependencies:

    ```
    composer install
    ```

    The main development dependencies for testing are:

    - `phpunit/phpunit`
    - `orchestra/testbench`
    - `nunomaduro/collision`

Running Tests
-------------

[](#running-tests)

You can run the tests using the following Composer scripts defined in `composer.json`:

- **Run the test suite:**This command executes the entire test suite.

    ```
    composer test
    ```
- **Run the test suite with testdox format:**This command runs the tests and displays the output in a "testdox" format, which is more readable.

    ```
    composer testdox
    ```

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a pull request.

1. Fork the repository.
2. Create a new branch (`git checkout -b feature/your-feature`).
3. Commit your changes (`git commit -am 'Add some feature'`).
4. Push to the branch (`git push origin feature/your-feature`).
5. Create a new Pull Request.
6. [1688 Api](https://open.1688.com/api/apidocdetail.htm?spm=1688open.api-list.0.0.257f55edkqmdkZ&aopApiCategory=trade_new&id=com.alibaba.trade%3Aalibaba.trade.fastCreateOrder-1)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance60

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

262d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/30a70d3f849243fd6b5ea624e533f1a6aa275bcb561195f8f84c082983e77dab?d=identicon)[AmadulHaque](/maintainers/AmadulHaque)

---

Top Contributors

[![AmadulHaque](https://avatars.githubusercontent.com/u/92516695?v=4)](https://github.com/AmadulHaque "AmadulHaque (5 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/amadulhaque-laravel-1688-package/health.svg)

```
[![Health](https://phpackages.com/badges/amadulhaque-laravel-1688-package/health.svg)](https://phpackages.com/packages/amadulhaque-laravel-1688-package)
```

###  Alternatives

[simplestats-io/laravel-client

Client for SimpleStats!

4515.5k](/packages/simplestats-io-laravel-client)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1344.8k1](/packages/jasara-php-amzn-selling-partner-api)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)