PHPackages                             issuebadge/laravel-sdk - 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. issuebadge/laravel-sdk

ActiveLibrary[API Development](/categories/api)

issuebadge/laravel-sdk
======================

Official Laravel SDK for IssueBadge API

00PHP

Since Oct 18Pushed 6mo agoCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

IssueBadge Laravel SDK
======================

[](#issuebadge-laravel-sdk)

Official Laravel SDK for IssueBadge API.

Requirements
------------

[](#requirements)

- PHP 8.0 or higher
- Laravel 9.0 or higher

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

[](#installation)

Install the package via Composer:

```
composer require issuebadge/laravel-sdk
```

Configuration
-------------

[](#configuration)

Publish the configuration file:

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

Add your IssueBadge API key to your `.env` file:

```
ISSUEBADGE_API_KEY=your-api-key-here
```

Optional configuration:

```
ISSUEBADGE_BASE_URL=https://app.issuebadge.com/api/v1
ISSUEBADGE_TIMEOUT=30
```

Usage
-----

[](#usage)

### Using the Facade

[](#using-the-facade)

```
use IssueBadge\Laravel\Facades\IssueBadge;

// Validate API key
$validation = IssueBadge::validateKey();
echo "User: " . $validation->user->name;

// Get all badges
$badges = IssueBadge::getAllBadges();
foreach ($badges->badges() as $badge) {
    echo $badge->name . " (ID: " . $badge->id . ")\n";
}

// Issue a badge
$response = IssueBadge::issueBadge([
    'name' => 'John Doe',
    'badge_id' => 'W238GD8PK',
    'idempotency_key' => 'unique-key-123',
    'email' => 'john@example.com',
]);

// Issue a badge with auto-generated idempotency key
$response = IssueBadge::issueBadgeWithAutoKey(
    'Jane Smith',
    'W238GD8PK',
    'jane@example.com'
);
```

### Using Dependency Injection

[](#using-dependency-injection)

```