PHPackages                             surender/prodege-api - 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. surender/prodege-api

ActiveLibrary[API Development](/categories/api)

surender/prodege-api
====================

Laravel package for Prodege MR API integration

v1.0.3(9mo ago)0254MITPHPPHP >=8.0

Since Apr 10Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/surenderrawat1/prodege-api)[ Packagist](https://packagist.org/packages/surender/prodege-api)[ RSS](/packages/surender-prodege-api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (2)Versions (5)Used By (0)

🧩 Laravel Prodege MR API Package
================================

[](#-laravel-prodege-mr-api-package)

A Laravel package for seamless integration with the **Prodege MR API**, featuring secure request signing, time offset handling, and robust response management — all wrapped in a clean, facade-based interface.

---

🚀 Features
----------

[](#-features)

- ✅ Signed API requests with SHA-256 HMAC
- 🕒 Time offset handling via `/lookup-request-time-offset`
- 🧱 Laravel Facade support (`ProdegeApi::post(...)`)
- 🧠 Smart response handling with automatic message normalization
- 🔧 Null implementation (`NullProdegeService`) for local/testing environments

---

📦 Installation
--------------

[](#-installation)

Install via [Packagist](https://packagist.org/):

```
composer require surender/prodege-api
```

⚙️ Configuration
----------------

[](#️-configuration)

```
php artisan vendor:publish --tag=prodege-config
```

Set up your .env:
-----------------

[](#set-up-your-env)

```
 PRODEGE_API_KEY=your_api_key
 PRODEGE_SECRET=your_secret
 PRODEGE_BASE_URL=https://api.prodegemr.com
```

✅ Usage
-------

[](#-usage)

```
use Surender\ProdegeApi\Facades\ProdegeApi;

$response = ProdegeApi::post('project-create', [
    'project_id' => 1234001,
    'project_type_id' => 1,
    'project_name' => 'Test Project',
    'loi' => 60,
    'country_id' => 1,
    'project_url' => 'http://www.google.com/?tr_id=%transid%',
    'cpi' => 2.25,
    'mobile_optimized' => 'true',
    'sample_size' => 100,
    'expected_ir' => 90
]);

if ($response->isSuccess()) {
    return response()->json([
        'message' => $response->getMessage(),
        'response' => $response->toArray(),
    ]);
}

return response()->json([
    'message' => $response->getMessage(),
    'errors' => $response->getErrorCodes(),
    'response' => $response->toArray(),
], 422);
```

🧰 Utilities
-----------

[](#-utilities)

Generate Signed URL

```
$url = ProdegeApi::generateSignedUrl('target-endpoint', ['key' => 'value']);
```

Generate Signed Params

```
$params = ProdegeApi::generateSignedParams(['key' => 'value']);
```

🧪 Testing in Local Environment
------------------------------

[](#-testing-in-local-environment)

Prevent real API calls using the NullProdegeService:

```
use Surender\ProdegeApi\Contracts\ProdegeApiInterface;
use Surender\ProdegeApi\Services\NullProdegeService;

$this->app->bind(ProdegeApiInterface::class, NullProdegeService::class);
```

🔍 ResponseHandler Methods
-------------------------

[](#-responsehandler-methods)

Method Description

- isSuccess() Returns true if status\_id is 1
- getMessage() Gets first message (handles string or array)
- getMessages() Gets all messages as array
- getErrorCodes() Returns any error codes
- toArray() Returns the raw API response

📄 License
---------

[](#-license)

- MIT License. See LICENSE file.

🙌 Contributing
--------------

[](#-contributing)

- Pull requests and issues are welcome! If you're planning a big change, open an issue first to discuss.

Let me know if you want a sample Laravel controller, targeting payload format, or if you'd like me to generate a GitHub Actions workflow for automatic testing and tag-based version release 🚀

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance57

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.5% 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

Every ~38 days

Total

4

Last Release

286d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d16506cccb30fbf2290acdff94f79f1fe23cd7ede3613f67c6d6ccbf3997bfc6?d=identicon)[surenderrawat1](/maintainers/surenderrawat1)

---

Top Contributors

[![surenderAshmar](https://avatars.githubusercontent.com/u/44959435?v=4)](https://github.com/surenderAshmar "surenderAshmar (7 commits)")[![surenderrawat1](https://avatars.githubusercontent.com/u/206991992?v=4)](https://github.com/surenderrawat1 "surenderrawat1 (1 commits)")

### Embed Badge

![Health badge](/badges/surender-prodege-api/health.svg)

```
[![Health](https://phpackages.com/badges/surender-prodege-api/health.svg)](https://phpackages.com/packages/surender-prodege-api)
```

###  Alternatives

[skagarwal/google-places-api

Google Places Api

1913.0M8](/packages/skagarwal-google-places-api)[dcblogdev/laravel-microsoft-graph

A Laravel Microsoft Graph API (Office365) package

168285.5k1](/packages/dcblogdev-laravel-microsoft-graph)[vluzrmos/slack-api

Wrapper for Slack.com WEB API.

102589.1k3](/packages/vluzrmos-slack-api)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[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)[grantholle/powerschool-api

A Laravel package to make interacting with PowerSchool less painful.

1715.6k1](/packages/grantholle-powerschool-api)

PHPackages © 2026

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