deezer-node
Version:
Deezer platformundan API Key olmadan bilgiler çekebilmenizi sağlar.
301 lines (250 loc) • 8.03 kB
Markdown
> Deezer'a bağlı bir modül veya Deezer tarafından yapılan, yaptırılan bir modül "değildir."
# Güncelleme Notları
- `getSong()` methodunda `<song>.artist.image`, `<song>.artist.tracks`, `<song>.album.image`, `<song>.album.tracks` eklendi.
- `getAlbum()` methodunda `<album>.type` ve `<album>.id` eklendi.
- Modül optimizasyonları yapıldı.
- Hata ve önerileriniz için bir [topluluk sunucusu](https://discord.gg/E6dQzfFgv6) açıldı.
- `search()` methodu eklendi.
> Modülü kullandığınız için teşekkür ederiz. ^^
<br>
# Deezer Node Hakkında
Deezer Node, Deezer üzerinden API Token Key olmadan bilgiler çekebilmenizi sağlar.
<br/>
<br/>
> ## Methodlar
<br/>
- `getAlbum("Albüm adı")` → **Arattığınız `albümü` arar ve bilgiler yollar.**
- `getArtist("Şarkıcı adı")` → **Arattığınız `şarkıcıyı` arar ve bilgiler yollar.**
- `getLyrics("Şarkı adı")` → **Arattığınız şarkının sözlerini bulur ve yollar** (`lyrics-finder` eklentisi kullanılmıştır.)
- `getSong("Şarkı adı")` → **Şarkıyı arar ve `Deezer üzerindeki` bilgileri yollar.**
- `getTracks("Şarkıcının Tracks URL'si")` → **Arattığınız şarkıcının `.tracks` bağlantısı ile şarkılarına ulaşabilirsiniz. (Maks. Şarkı: 50)**
- `search("Aranılacak değer")` → **`Deezer` üzerinde arama yaparsınız**
<br/>
<br/>
> ## Kullanım
<br/>
- ### `getAlbum("Albüm adı")`
<br/>
```js
// Bu bir async fonksiyonu. (This is an async function.)
const deezer = require("deezer-node");
const album = await deezer.getAlbum("Uçurtma")
return console.log(album);
```
> Albüm bulunmadığı takdirde `undefined` değerini gönderir.
<br/>
```js
{
name: 'Uçurtma',
image: 'http://api.deezer.com/album/109251382/image',
tracks: 'http://api.deezer.com/album/109251382/tracks',
type: 'album',
id: 109251382
}
```
<br/>
- ### `getArtist("Şarkıcı adı")`
<br/>
```js
// Bu bir async fonksiyonu. (This is an async function.)
const deezer = require("deezer-node");
const artist = await deezer.getArtist("Taladro")
return console.log(artist);
```
> Şarkıcı bulunmadığı takdirde `undefined` değerini gönderir.
<br/>
```js
{
name: 'Taladro',
id: 8720682,
visit: 'http://www.deezer.com/artist/8720682',
image: 'http://api.deezer.com/artist/8720682/image',
type: 'artist',
tracks: 'http://api.deezer.com/artist/8720682/top?limit=50'
}
```
<br/>
- ### `getLyrics("Şarkı adı")`
<br/>
```js
// Bu bir async fonksiyonu. (This is an async function.)
const deezer = require("deezer-node");
const lyrics = await deezer.getLyrics("Dudaklarında Yalan Kalmış")
return console.log(lyrics);
```
> Şarkı sözleri bulunmadığı takdirde `undefined` değerini gönderir.
<br/>
```string
Seni özlemiyor değilim ha
Sadece yollarını gözlemiyorum
Düşlerimde bahçesinde kaç çiçeğin katilisin
Bilsen, başka bir şey söylemiyorum
Hırs fazla zararlıdır hırslanana
Yağmur ıslanana, ilişki kıskanana
Dayanmaz iki topuğum hızlanana
Ve sen bu şehre geç gelen bir yağmursun ıslanamam
```
> Çok uzun olduğu için çıktı kısaltıldı.
<br>
- ### `getSong("Şarkı adı")`
<br/>
```js
// Bu bir async fonksiyonu. (This is an async function.)
const deezer = require("deezer-node");
const song = await deezer.getSong("Dudaklarında Yalan Kalmış")
return console.log(song);
```
> Şarkı bilgisi bulunmadığı takdirde `undefined` değerini gönderir.
<br/>
```js
{
name: 'Dudaklarında Yalan Kalmış',
id: 1773432937,
image: 'http://api.deezer.com/album/323474637/image',
visit: 'http://www.deezer.com/track/1773432937',
duration: 200000, // Bu veri milisaniye cinsinden verilmektedir. (This is a milliseconds.)
list: 362364,
preview: 'http://cdn-preview-2.deezer.com/stream/c-210a81bb57231e8226caf323358bcd3b-2.mp3',
explicitLyrics: false,
artist: {
name: 'Taladro',
id: 8720682,
image: 'http://api.deezer.com/artist/8720682/image'
},
album: {
name: 'Dudaklarında Yalan Kalmış',
id: 323474637,
image: 'http://api.deezer.com/album/323474637/image'
},
type: 'track'
}
```
<br>
- ### `getTracks("Şarkıcı Tracks URL'si")`
<br/>
```js
// Bu bir async fonksiyonu. (This is an async function.)
const deezer = require("deezer-node");
const artist = await deezer.getArtist("Taladro");
const tracks = (artist?.tracks) ? await deezer.getTracks(artist.tracks) : [];
const songs = await tracks.map(song => song.name).slice(0, 10);
return console.log(songs);
```
> Şarkıcı Tracks URL'si bulunmadığı takdirde ya da şarkıcının şarkısı olmaması ya da hata gibi problemlerde `[]` değerini gönderir.
<br/>
```js
[
'Uçurtma',
'Darağacı',
'Dudaklarında Yalan Kalmış',
'Dem',
'Deniz Kızı',
'Yürüyorum Dikenlerin Üstünde',
'Yarım Kalanlar (feat. Özge Şabo)',
'Senin Yüzünden',
'Nafile',
'Caddeler'
]
```
<br>
- ### `search("Aranılacak değer")`
<br/>
```js
// Bu bir async fonksiyonu. (This is an async function.)
const deezer = require("deezer-node");
const search = await deezer.search("Taladro");
return console.log(search);
```
> Arama değeri bulunamadığı takdirde `[]` çıktısını gönderir.
<br/>
```js
[
{
name: 'Unutamazsın',
id: 499769982,
visit: 'http://www.deezer.com/track/499769982',
duration: 238,
explicitLyrics: false,
artist: {
name: 'Taladro',
id: 63525942,
visit: 'http://www.deezer.com/artist/8720682',
image: 'http://api.deezer.com/artist/8720682/image'
},
album: {
name: 'Beşinci Mevsim',
id: 63525942,
image: 'http://api.deezer.com/album/63525942/image',
tracks: 'http://api.deezer.com/album/63525942/tracks'
},
type: 'track'
},
{
name: 'Beşinci Mevsim',
id: 499769992,
visit: 'http://www.deezer.com/track/499769992',
duration: 342,
explicitLyrics: false,
artist: {
name: 'Taladro',
id: 63525942,
visit: 'http://www.deezer.com/artist/8720682',
image: 'http://api.deezer.com/artist/8720682/image'
},
album: {
name: 'Beşinci Mevsim',
id: 63525942,
image: 'http://api.deezer.com/album/63525942/image',
tracks: 'http://api.deezer.com/album/63525942/tracks'
},
type: 'track'
},
{
name: 'Neyiz Biz',
id: 499770012,
visit: 'http://www.deezer.com/track/499770012',
duration: 310,
explicitLyrics: false,
artist: {
name: 'Taladro',
id: 63525942,
visit: 'http://www.deezer.com/artist/8720682',
image: 'http://api.deezer.com/artist/8720682/image'
},
album: {
name: 'Beşinci Mevsim',
id: 63525942,
image: 'http://api.deezer.com/album/63525942/image',
tracks: 'http://api.deezer.com/album/63525942/tracks'
},
type: 'track'
},
{
name: 'Siyah Gelinlik',
id: 499770002,
visit: 'http://www.deezer.com/track/499770002',
duration: 245,
explicitLyrics: false,
artist: {
name: 'Taladro',
id: 63525942,
visit: 'http://www.deezer.com/artist/8720682',
image: 'http://api.deezer.com/artist/8720682/image'
},
album: {
name: 'Beşinci Mevsim',
id: 63525942,
image: 'http://api.deezer.com/album/63525942/image',
tracks: 'http://api.deezer.com/album/63525942/tracks'
},
type: 'track'
}
]
```
<br>
# İletişim
<br>
[Discord Sunucusu](https://discord.gg/E6dQzfFgv6)<br>
[tr.ahmet.cakir@gmail.com](mailto:tr.ahmet.cakir@gmail.com)