Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/slvler/balldontlie-service

balldontlie.io api service
https://github.com/slvler/balldontlie-service

api api-client api-service balldontlie balldontlie-api laravel laravel-package laravel-service

Last synced: 16 days ago
JSON representation

balldontlie.io api service

Host: GitHub
URL: https://github.com/slvler/balldontlie-service
Owner: slvler
License: mit
Created: 2023-06-30T19:27:45.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-11-06T22:41:45.000Z (about 1 year ago)
Last Synced: 2024-10-12T06:46:05.229Z (about 1 month ago)
Topics: api, api-client, api-service, balldontlie, balldontlie-api, laravel, laravel-package, laravel-service
Language: PHP
Homepage:
Size: 17.6 KB
Stars: 10
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md

Awesome Lists containing this project

README

# balldontlie Service

[![tests](https://github.com/slvler/balldontlie-service/actions/workflows/tests.yml/badge.svg)](https://github.com/slvler/balldontlie-service/actions/workflows/tests.yml)
[![Latest Stable Version](https://poser.pugx.org/slvler/balldontlie-laravel/v)](https://packagist.org/packages/slvler/balldontlie-laravel)
[![Latest Unstable Version](https://poser.pugx.org/slvler/balldontlie-laravel/v/unstable)](https://packagist.org/packages/slvler/balldontlie-laravel)
[![License](https://poser.pugx.org/slvler/balldontlie-laravel/license)](https://packagist.org/packages/slvler/balldontlie-laravel)
[![Total Downloads](https://poser.pugx.org/slvler/balldontlie-laravel/downloads)](https://packagist.org/packages/slvler/balldontlie-laravel)

This package provides a convenient wrapper to the [Balldontlie API](https://www.balldontlie.io/home.html#introduction) for Laravel applications.

## Requirements

- PHP 8.0+
- Laravel 9.x

## Installation

To install this package tou can use composer:

```bash
composer require slvler/balldontlie-laravel
```

## Usage

#### Find player
```php
Balldontlie::players(237);
```
it returns an json with player:
```json
{
"data":[
{
"id":237,
"first_name":"LeBron",
"last_name":"James",
"position":"F",
"height_feet": 6,
"height_inches": 8,
"weight_pounds": 250,
"team":{
"id":14,
"abbreviation":"LAL",
"city":"Los Angeles",
"conference":"West",
"division":"Pacific",
"full_name":"Los Angeles Lakers",
"name":"Lakers"
}
}
],
"meta": {
"total_pages": 50,
"current_page": 1,
"next_page": 2,
"per_page": 25,
"total_count": 9999
}
}
```

#### Find team
```php
Balldontlie::teams(14);
```
it returns an json with team:
```json
{
"data": [
{
"id":14,
"abbreviation":"LAL",
"city":"Los Angeles",
"conference":"West",
"division":"Pacific",
"full_name":"Los Angeles Lakers",
"name":"Lakers"
}
],
"meta": {
"total_pages": 1,
"current_page": 1,
"next_page": null,
"per_page": 30,
"total_count": 30
}
}
```
#### Find games
```php
Balldontlie::games(1);
```
it returns an json with games:
```json
{
"data": [
{
"id":1,
"date":"2018-10-16T00:00:00.000Z",
"home_team_score":105,
"visitor_team_score":87,
"season":2018,
"period": 4,
"status": "Final",
"time": " ",
"postseason": false,
"home_team":{
"id":2,
"abbreviation":"BOS",
"city":"Boston",
"conference":"East",
"division":"Atlantic",
"full_name":"Boston Celtics",
"name":"Celtics"
},
"visitor_team":{
"id":23,
"abbreviation":"PHI",
"city":"Philadelphia",
"conference":"East",
"division":"Atlantic",
"full_name":"Philadelphia 76ers",
"name":"76ers"
}
}
],
"meta": {
"total_pages": 1877,
"current_page": 1,
"next_page": 2,
"per_page": 25,
"total_count": 46911
}
}
```

#### Find stats
```php
Balldontlie::stats();
```
it returns an json with stats:
```json
{
"data": [
{
"id":29,
"ast":2,
"blk":2,
"dreb":8,
"fg3_pct":0.25,
"fg3a":4,
"fg3m":1,
"fg_pct":0.429,
"fga":21,
"fgm":9,
"ft_pct":0.8,
"fta":5,
"ftm":4,
"game":{
"id":1,
"date":"2018-10-16T00:00:00.000Z",
"home_team_id":2,
"home_team_score":105,
"season":2018,
"visitor_team_id":23,
"visitor_team_score":87
},
"min":"36:49",
"oreb":2,
"pf":3,
"player":{
"id":145,
"first_name":"Joel",
"last_name":"Embiid",
"position":"F-C",
"team_id":23
},
"pts":23,
"reb":10,
"stl":1,
"team":{
"id":23,
"abbreviation":"PHI",
"city":"Philadelphia",
"conference":"East",
"division":"Atlantic",
"full_name":"Philadelphia 76ers",
"name":"76ers"
},
"turnover":5
}
],
"meta": {
"total_pages": 2042,
"current_page": 1,
"next_page": 2,
"per_page": 25,
"total_count": 51045
}
}
```

## Testing

```bash
composer test
```

## Credits

- [slvler](https://github.com/slvler)

## License

The MIT License (MIT). Please see [License File](https://github.com/slvler/balldontlie-service/blob/main/LICENSE.md) for more information.

## Contributing
You're very welcome to contribute.
Please see [CONTRIBUTING](https://github.com/slvler/balldontlie-service/blob/main/CONTRIBUTING.md) for details.