cable8mm/water-melon

Water Melon is simple melon.com api sdk for php

v1.1.3 2024-03-09 08:03 UTC

Requires

• php: ^8.0
• guzzlehttp/guzzle: ^7.5

Requires (Dev)

• laravel/pint: ^1.0
• phpunit/phpunit: ^9.0|^10.0|^11.0

MIT

• Sam Lee

• php
• phpunit
• development
• crawler
• melon

README

Water Melon

This library is designed for retrieving information about artists, songs, and albums using their respective IDs from https://www.melon.com.

We have provided the API Documentation on the web. For more information, please visit https://www.palgle.com/water-melon/ ❤️

Features

• Fetches information about songs, artists, and albums
• To be able to retrieve information about artists and albums using the Melon song ID
• Customize the fields according to your needs for easy access

Installation

composer require cable8mm/water-melon

Usage

Get song info:

$waterMelon = WaterMelon::make(35945927);   // Ditto's song id

print $waterMelon->song->id;
//=> 35945927

print $waterMelon->album->id;
//=> 11127145

print $waterMelon->artists[0]->id;
//=> 3114174

and fantastic resource inspired by laravel resource:

$waterMelon = WaterMelon::make(35945927);
// Ditto's Melon song ID

$song = SongResource::make($waterMelon->getSong());

print $song->title;
//=> Ditto
print $song->album_id;
//=> 11127145
print $song->artwork_image_path;
//=> https://cdnimg.melon.co.kr/cm2/album/images/111/27/145/11127145_20231213133532_500.jpg?42f8389c13de0f5f8e4c722bbb0d4bd7/melon/resize/144/optimize/90

$artist = ArtistResource::make($waterMelon->getArtists()[0]);

print $artist->melon_artistid;
//=> 3114174
print $artist->name;
//=> NewJeans
print $artist->featured_image_path;
//=> https://cdnimg.melon.co.kr/cm2/artistcrop/images/031/14/174/3114174_20231219153524_500.jpg?8d4887c3dea0a5262fe256c1aef2a9d2/melon/resize/100/optimize/90

$album = AlbumResource::make($waterMelon->getAlbum());

print $album->melon_albumid;
//=> 11127145
print $album->title;
//=> NewJeans 'OMG'
print $album->album_cover_path;
//=> https://cdnimg.melon.co.kr/cm2/album/images/111/27/145/11127145_20231213133532_500.jpg?42f8389c13de0f5f8e4c722bbb0d4bd7/melon/resize/255/optimize/90
print $album->released_at;
//=> 2023.01.02

Specification

You can refer to the Markdown documents for melon.com JSON specifications:

• Song Document
• Album Document
• Artist Document

Lint

composer lint

Test

composer test

License

The Water Melon project is open-sourced software licensed under the MIT license.