Download the PHP package zdearo/meli-php without Composer
On this page you can find all versions of the php package zdearo/meli-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download zdearo/meli-php
More information about zdearo/meli-php
Files in zdearo/meli-php
Package meli-php
Short Description A Laravel-focused PHP SDK for integrating with the Mercado Libre API. Provides modern Laravel features like Facades, Service Providers, and HTTP Client integration.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package meli-php
Mercado Libre PHP SDK
A modern Laravel package for integrating with the Mercado Libre API. Provides typed DTOs, custom exceptions, automatic pagination, optional retry, and a clean Facade interface.
Features
- Complete API Coverage: 11 services covering all major Mercado Libre API endpoints
- Typed DTOs: Readonly data objects with IDE autocomplete (
Product,Order,User,Payment,Question,Category,AuthToken) - Custom Exceptions: Typed exceptions for every API error (
MeliNotFoundException,MeliValidationException,MeliAuthException, etc.) - Lazy Pagination: Automatic page-by-page iteration via
LazyCollection - Optional Retry: Configurable retry with backoff for rate limits (429) and server errors (5xx)
- Multi-Tenancy: Per-request token resolution with
withToken()andforConnection() - Multi-Region: Support for all 19 Latin American marketplaces
- Laravel Boost: Includes AI guidelines and skills for AI-assisted development
- Modern PHP: PHP 8.3+ with readonly classes, enums, and named arguments
Requirements
- PHP 8.3+
- Laravel 9.0–13.x
Installation
The package will be auto-discovered by Laravel.
Configuration
Publish the configuration file:
Configure your environment variables in .env:
Quick Start
Basic Usage
Authentication (OAuth 2.0)
Multi-Tenancy
Working with Products
Available Services
| Accessor | Service | Returns |
|---|---|---|
Meli::auth() |
AuthService | AuthToken |
Meli::products() |
ProductService | Product |
Meli::orders() |
OrderService | Order, SearchResult |
Meli::users() |
UserService | User |
Meli::payments() |
PaymentService | Payment, SearchResult |
Meli::questions() |
QuestionService | Question, SearchResult |
Meli::categories() |
CategoryService | Category |
Meli::searchItem() |
SearchItemService | SearchResult |
Meli::visits() |
VisitsService | Response |
Meli::notifications() |
NotificationService | SearchResult |
Meli::documentation() |
DocumentationService | array |
For detailed documentation of all services and methods, see SERVICES.md.
Error Handling
The package throws typed exceptions for all API errors:
| Exception | HTTP Status |
|---|---|
MeliAuthException |
401 |
MeliForbiddenException |
403 |
MeliNotFoundException |
404 |
MeliValidationException |
400 |
MeliRateLimitException |
429 |
MeliServerException |
500+ |
MeliException |
Any other |
Lazy Pagination
Search methods return SearchResult DTOs with pagination metadata. Use searchAll() to iterate lazily:
Available on: OrderService, QuestionService, PaymentService, NotificationService, SearchItemService.
Retry Configuration
Retry is disabled by default. To enable automatic retry on rate limit (429) and server errors (5xx):
Example Controller
Documentation Service (MCP)
Access Mercado Libre's technical documentation programmatically via the MCP server:
Laravel Boost Support
This package includes AI guidelines and skills for Laravel Boost. When installed alongside Boost, running php artisan boost:install will automatically include Meli SDK guidelines and the meli-development skill.
Testing
Code Style
License
MIT License. See LICENSE for more details.
All versions of meli-php with dependencies
illuminate/support Version ^9.0|^10.0|^11.0|^12.0|^13.0
illuminate/http Version ^9.0|^10.0|^11.0|^12.0|^13.0