Template:Text formatting template (see also): Difference between revisions
More actions
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
< | Dagiti plantilia a naus-usar iti daytoy a panid: | ||
-- | |||
'''Voice Recorder'''>Sor.ly text<=/small>'Plantilia:Dakkel ( kitaen ti taudan ) (nasalakniban ti editor ti plantilia) | |||
Plantilia:C ( kitaen ti taudan ) (semi-nasalakniban) . | |||
Plantilia:C/display ( kitaen ti taudan ) (semi-nasalakniban) . | |||
Plantilia:Ilo ( kitaen ti taudan ) (nasalakniban) . | |||
Plantilia:Exp ( urnos ) . | |||
Plantilia:Ilawlawag ( urnosen ) . | |||
Plantilia:Kadakkel ti letra ( urnos ) . | |||
Plantilia:I-highlight ( i- edit ) . | |||
Plantilia:Marka ( urnosen ) . | |||
Plantilia:Overline ( urnosen ) . | |||
Plantilia:Baliwan ti kadakkel ( urnosen ) . | |||
Plantilia:Bassit ( kitaen ti taudan ) (semi-nasalakniban) . | |||
Plantilia:Small-caps ( kitaen ti taudan ) (semi-nasalakniban) . | |||
Plantilia:Small-caps/estilo.css ( urnosen ) . | |||
Plantilia:Bassit a sub ( urnos ) . | |||
Plantilia:Smallsup ( urnosen ) . | |||
Plantilia:Sub ( urnos ) . | |||
Plantilia:Sup sub ( urnos ) . | |||
Plantilia:T/kangrunaan ( kitaen ti taudan ) (nasalakniban) . | |||
Plantilia:Tl ( kitaen ti taudan ) (nasalakniban) . | |||
Plantilia:Tlx ( kitaen ti taudan ) (nasalakniban) . | |||
Plantilia:Pakdaar a karatula ( urnosen ) . | |||
Plantilia:Pakdaar ( urnos ) . | |||
Modulo:Core ( kitaen ti taudan ) (nasalakniban ti editor ti plantilia) . | |||
Modulo:Deskripsion ( kitaen ti taudan ) (nasalakniban ti editor ti plantilia) Lumaktaw sa nilalaman | |||
Saklaw | |||
Ang mga saklaw ay nagbibigay sa mga user ng Spotify na gumagamit ng mga third-party na app ng kumpiyansa na tanging ang impormasyong pipiliin nilang ibahagi ang ibabahagi, at wala nang iba pa. | |||
Pre-requisites | |||
Kinakailangan ang mga saklaw kapag nagpapatupad ng ilan sa mga uri ng pagbibigay ng pahintulot. Tiyaking nabasa mo ang gabay sa Pagpapahintulot upang maunawaan ang mga pangunahing kaalaman. | |||
Listahan ng mga Saklaw | |||
Mga imahe | |||
ugc-image-upload | |||
Spotify Connect | |||
user-read-playback-state | |||
: | user-modify-playback-state | ||
user-read-kasalukuyang-naglalaro | |||
Pag-playback | |||
app-remote-control | |||
streaming | |||
Mga playlist | |||
playlist-read-private | |||
playlist-read-collaborative | |||
playlist-modify-private | |||
playlist-modify-public | |||
Sundin | |||
user-follow-modify | |||
user-follow-read | |||
Kasaysayan ng Pakikinig | |||
user-read-playback-posisyon | |||
user-top-read | |||
user-read-recently-played | |||
Aklatan | |||
user-library-modify | |||
user-library-read | |||
Mga gumagamit | |||
user-read-email | |||
user-read-private | |||
Buksan ang Access | |||
user-soa-link | |||
user-soa-unlink | |||
soa-manage-entitlements | |||
soa-manage-partner | |||
soa-create-partner | |||
ugc-image-upload | |||
Paglalarawan Magsulat ng access sa mga larawang ibinigay ng user. | |||
Nakikita ng mga gumagamit Mag-upload ng mga larawan sa Spotify para sa iyo. | |||
Mga endpoint na nangangailangan ng ugc-image-uploadsaklaw | |||
Magdagdag ng Custom na Playlist Cover Image | |||
user-read-playback-state | |||
Paglalarawan Basahin ang access sa status ng player ng isang user. | |||
Nakikita ng mga gumagamit Basahin ang iyong kasalukuyang nagpe-play na content at impormasyon ng mga device sa Spotify Connect. | |||
Mga endpoint na nangangailangan ng user-read-playback-statesaklaw | |||
Kumuha ng Mga Available na Device ng User | |||
Kumuha ng Impormasyon Tungkol sa Kasalukuyang Pag-playback ng User | |||
Kunin ang Kasalukuyang Nagpe-play na Track ng User | |||
user-modify-playback-state | |||
Paglalarawan Magsulat ng access sa estado ng pag-playback ng isang user | |||
Nakikita ng mga gumagamit Kontrolin ang pag-playback sa iyong mga kliyente sa Spotify at mga Spotify Connect device. | |||
Mga endpoint na nangangailangan ng user-modify-playback-statesaklaw | |||
I-pause ang Pag-playback ng User | |||
Maghangad na Puwesto Sa Kasalukuyang Nagpe-play ng Track | |||
Itakda ang Repeat Mode Sa Pag-playback ng User | |||
Itakda ang Volume Para sa Pag-playback ng User | |||
Laktawan ang Playback ng User Sa Susunod na Track | |||
Laktawan ang Playback ng User Sa Nakaraang Track | |||
Simulan/Ipagpatuloy ang Pag-playback ng User | |||
I-toggle ang Shuffle Para sa Pag-playback ng User | |||
Maglipat ng Playback ng User | |||
Magdagdag ng Item sa Dulo ng Kasalukuyang Playback Queue ng User | |||
user-read-currently-playing | |||
Paglalarawan Magbasa ng access sa kasalukuyang nagpe-play na content ng isang user. | |||
Nakikita ng mga gumagamit Basahin ang iyong kasalukuyang nagpe-play na nilalaman. | |||
Mga endpoint na nangangailangan ng user-read-currently-playingsaklaw | |||
Kunin ang Kasalukuyang Nagpe-play na Track ng User | |||
Kunin ang Queue ng User | |||
app-remote-control | |||
Paglalarawan Remote control playback ng Spotify. Ang saklaw na ito ay kasalukuyang available sa Spotify iOS at Android SDK. | |||
Nakikita ng mga gumagamit Makipag-ugnayan sa Spotify app sa iyong device. | |||
Mga endpoint na nangangailangan ng app-remote-controlsaklaw | |||
iOS SDK | |||
Android SDK | |||
streaming | |||
Paglalarawan Kontrolin ang pag-playback ng isang Spotify track. Ang saklaw na ito ay kasalukuyang available sa Web Playback SDK. Dapat ay mayroong Spotify Premium account ang user. | |||
Nakikita ng mga gumagamit Mag-play ng content at kontrolin ang pag-playback sa iba mo pang device. | |||
Mga endpoint na nangangailangan ng streamingsaklaw | |||
Web Playback SDK | |||
playlist-read-private | |||
Paglalarawan Basahin ang access sa mga pribadong playlist ng user. | |||
Nakikita ng mga gumagamit I-access ang iyong mga pribadong playlist. | |||
Mga endpoint na nangangailangan ng playlist-read-privatesaklaw | |||
Suriin kung Sinusundan ng Mga Gumagamit ang isang Playlist | |||
Kumuha ng Listahan ng Mga Kasalukuyang Playlist ng User | |||
Kumuha ng Listahan ng Mga Playlist ng User | |||
playlist-read-collaborative | |||
Paglalarawan Isama ang mga collaborative na playlist kapag humihiling ng mga playlist ng user. | |||
Nakikita ng mga gumagamit I-access ang iyong mga collaborative na playlist. | |||
Mga endpoint na nangangailangan ng playlist-read-collaborativesaklaw | |||
Kumuha ng Listahan ng Mga Kasalukuyang Playlist ng User | |||
Kumuha ng Listahan ng Mga Playlist ng User | |||
playlist-modify-private | |||
Paglalarawan Magsulat ng access sa mga pribadong playlist ng user. | |||
Nakikita ng mga gumagamit Pamahalaan ang iyong mga pribadong playlist. | |||
Mga endpoint na nangangailangan ng playlist-modify-privatesaklaw | |||
Sundin ang isang Playlist | |||
I-unfollow ang isang Playlist | |||
Magdagdag ng Mga Item sa isang Playlist | |||
Baguhin ang Mga Detalye ng Playlist | |||
Gumawa ng Playlist | |||
Alisin ang Mga Item mula sa isang Playlist | |||
Ayusin muli ang Mga Item ng Playlist | |||
Palitan ang Mga Item ng Playlist | |||
Mag-upload ng Custom na Playlist Cover Image | |||
playlist-modify-public | |||
Paglalarawan Magsulat ng access sa mga pampublikong playlist ng isang user. | |||
Nakikita ng mga gumagamit Pamahalaan ang iyong mga pampublikong playlist. | |||
Mga endpoint na nangangailangan ng playlist-modify-publicsaklaw | |||
Sundin ang isang Playlist | |||
I-unfollow ang isang Playlist | |||
Magdagdag ng Mga Item sa isang Playlist | |||
Baguhin ang Mga Detalye ng Playlist | |||
Gumawa ng Playlist | |||
Alisin ang Mga Item mula sa isang Playlist | |||
Ayusin muli ang Mga Item ng Playlist | |||
Palitan ang Mga Item ng Playlist | |||
Mag-upload ng Custom na Playlist Cover Image | |||
user-follow-modify | |||
Paglalarawan Sumulat/magtanggal ng access sa listahan ng mga artist at iba pang user na sinusundan ng user. | |||
Nakikita ng mga gumagamit Pamahalaan kung sino ang iyong sinusundan. | |||
Mga endpoint na nangangailangan ng user-follow-modifysaklaw | |||
Sundin ang Mga Artist o User | |||
I-unfollow ang Mga Artist o User | |||
user-follow-read | |||
Paglalarawan Basahin ang access sa listahan ng mga artist at iba pang user na sinusundan ng user. | |||
Nakikita ng mga gumagamit I-access ang iyong mga tagasunod at kung sino ang iyong sinusubaybayan. | |||
Mga endpoint na nangangailangan ng user-follow-readsaklaw | |||
Tingnan kung Sinusubaybayan ng Kasalukuyang Gumagamit ang Mga Artist o Mga User | |||
Kunin ang mga Sinusubaybayang Artist ng User | |||
user-read-playback-position | |||
Paglalarawan Basahin ang access sa posisyon ng pag-playback ng user sa isang content. | |||
Nakikita ng mga gumagamit Basahin ang iyong posisyon sa nilalaman na iyong nilalaro. | |||
Mga endpoint na nangangailangan ng user-read-playback-positionsaklaw | |||
Kumuha ng Episodes | |||
Kumuha ng Ilang Episode | |||
Kumuha ng isang Palabas | |||
Kumuha ng Ilang Palabas | |||
Kumuha ng Mga Episode ng Palabas | |||
user-top-read | |||
Paglalarawan Magbasa ng access sa mga nangungunang artist at track ng user. | |||
Nakikita ng mga gumagamit Basahin ang iyong mga nangungunang artist at nilalaman. | |||
Mga endpoint na nangangailangan ng user-top-readsaklaw | |||
Kumuha ng Mga Nangungunang Artist at Track ng User | |||
user-read-recently-played | |||
Paglalarawan Magbasa ng access sa mga kamakailang na-play na track ng isang user. | |||
Nakikita ng mga gumagamit I-access ang iyong mga kamakailang na-play na item. | |||
Mga endpoint na nangangailangan ng user-read-recently-playedsaklaw | |||
Kunin ang Mga Track ng Kasalukuyang Naglaro ng Kasalukuyang Gumagamit | |||
user-library-modify | |||
Paglalarawan Magsulat/magtanggal ng access sa library ng "Iyong Musika" ng user. | |||
Nakikita ng mga gumagamit Pamahalaan ang iyong naka-save na nilalaman. | |||
Mga endpoint na nangangailangan ng user-library-modifysaklaw | |||
Alisin ang Mga Album para sa Kasalukuyang Gumagamit | |||
Alisin ang Mga Na-save na Track ng User | |||
Alisin ang Mga Na-save na Episode ng User | |||
I-save ang Mga Album para sa Kasalukuyang Gumagamit | |||
I-save ang Mga Track para sa User | |||
I-save ang Mga Episode para sa User | |||
user-library-read | |||
Paglalarawan Magbasa ng access sa library ng isang user. | |||
Nakikita ng mga gumagamit I-access ang iyong naka-save na nilalaman. | |||
Mga endpoint na nangangailangan ng user-library-readsaklaw | |||
Suriin ang Mga Na-save na Album ng User | |||
Suriin ang Mga Na-save na Track ng User | |||
Kunin ang Mga Naka-save na Album ng Kasalukuyang User | |||
Kumuha ng Mga Na-save na Track ng User | |||
Suriin ang Mga Na-save na Episode ng User | |||
Kunin ang Mga Na-save na Episode ng User | |||
user-read-email | |||
Paglalarawan Basahin ang access sa email address ng user. | |||
Nakikita ng mga gumagamit Kunin ang iyong tunay na email address. | |||
Mga endpoint na nangangailangan ng user-read-emailsaklaw | |||
Kunin ang Profile ng Kasalukuyang User | |||
user-read-private | |||
Paglalarawan Basahin ang access sa mga detalye ng subscription ng user (uri ng user account). | |||
Nakikita ng mga gumagamit I-access ang mga detalye ng iyong subscription. | |||
Mga endpoint na nangangailangan ng user-read-privatesaklaw | |||
Maghanap ng isang Item | |||
Kunin ang Profile ng Kasalukuyang User | |||
user-soa-link | |||
Paglalarawan I-link ang isang partner na user account sa isang Spotify user account | |||
Mga endpoint na nangangailangan ng user-soa-linksaklaw | |||
Magrehistro ng bagong user | |||
user-soa-unlink | |||
Paglalarawan I-unlink ang isang partner na user account mula sa isang Spotify account | |||
Mga endpoint na nangangailangan ng user-soa-unlinksaklaw | |||
I-unlink ang user | |||
soa-manage-entitlements | |||
Paglalarawan Baguhin ang mga karapatan para sa mga naka-link na user | |||
Mga endpoint na nangangailangan ng soa-manage-entitlementssaklaw | |||
Magdagdag ng mga karapatan ng user | |||
Kumuha ng mga karapatan ng user | |||
Inaalis ang mga karapatan ng user | |||
Palitan ang mga karapatan ng user | |||
soa-manage-partner | |||
Paglalarawan I-update ang impormasyon ng kasosyo | |||
Mga endpoint na nangangailangan ng soa-manage-partnersaklaw | |||
Itakda ang logo ng kasosyo | |||
soa-create-partner | |||
Paglalarawan Lumikha ng mga bagong kasosyo, mga kasosyo sa platform lamang | |||
Mga endpoint na nangangailangan ng soa-create-partnersaklaw | |||
Gumawa ng bagong partner | |||
Footer | |||
DOKUMENTASYON | |||
Web API | |||
Web Playback SDK | |||
Ads API | |||
iOS | |||
Android | |||
Mga naka-embed | |||
Komersyal na Hardware | |||
MGA ALITUNTUNIN | |||
Disenyo | |||
Accessibility | |||
KOMUNIDAD | |||
Balita | |||
Forum | |||
LEGAL | |||
Mga Tuntunin ng Developer | |||
Patakaran ng Developer | |||
Mga Tip sa Pagsunod | |||
Mga Lisensya ng Third Party | |||
Legal | |||
Mga cookies | |||
© 2024 Spotify AB | |||
Kami at ang aming mga kasosyo ay gumagamit ng cookies upang i-personalize ang iyong karanasan, upang magpakita sa iyo ng mga ad batay sa iyong mga interes, at para sa mga layunin ng pagsukat at analytics. Sa pamamagitan ng paggamit ng aming website at mga serbisyo, sumasang-ayon ka sa aming paggamit ng cookies gaya ng inilarawan sa aming Patakaran sa Cookie. | |||
Laktawan ti linaon | |||
API ti Web • . | |||
Dagiti Reperensia / Dagiti Agus-usar / Alaen dagiti Nangato a Banag ti Agus-usar | |||
Alaen dagiti Nangruna a Banag ti Agus-usar | |||
OAuth nga 2.0 | |||
Alaen dagiti kangrunaan nga artista wenno track ti agdama nga agar-aramat a naibatay iti nakuenta nga affinity. | |||
Dagiti sakup ti autorisasion | |||
user-top-basaen ti agar-aramat | |||
Kiddaw | |||
ALAN | |||
/siak/ngato/{tipo} | |||
Sungbat | |||
200 nga | |||
401 nga | |||
403 nga | |||
429 nga | |||
Panid dagiti artista wenno track | |||
href | |||
kuerdas | |||
Kasapulan | |||
Ti silpo iti puntos ti panagpatingga ti Web API a mangisubli ti naan-anay a resulta ti kiddaw | |||
Pagwadan :"https://api.spotify.com/v1/me/shows?offset=0&limit=20" | |||
limitasion | |||
intero a bilang | |||
Kasapulan | |||
Ti kangatuan a bilang dagiti banag iti sungbat (kas naikeddeng iti panagsaludsod wenno babaen ti default). | |||
Pagwadan :20 | |||
sumaruno | |||
kuerdas | |||
Kasapulan | |||
Nullable nga | |||
URL iti sumaruno a panid dagiti banag. ( nullno awan) . | |||
Pagwadan :"https://api.spotify.com/v1/me/shows?offset=1&limit=1" | |||
offset ti | |||
intero a bilang | |||
Kasapulan | |||
Ti offset dagiti banag a naisubli (kas naikeddeng iti panagsaludsod wenno babaen ti default) . | |||
Pagwadan :0 | |||
napalabas | |||
kuerdas | |||
Kasapulan | |||
Nullable nga | |||
URL iti napalabas a panid dagiti banag. ( nullno awan) . | |||
Pagwadan :"https://api.spotify.com/v1/me/shows?offset=1&limit=1" | |||
dagup | |||
intero a bilang | |||
Kasapulan | |||
Ti dagup a bilang dagiti banag a magun-odan nga isubli. | |||
Pagwadan :4 | |||
dagiti banag | |||
array ti oneOfs | |||
Kasapulan | |||
Maysanto kadagiti sumaganad: | |||
ArtistObject | |||
banag | |||
dagiti_url iti ruar | |||
banag | |||
Dagiti ammo nga akinruar nga URL para iti daytoy nga artista. | |||
spotify ti panagkita | |||
kuerdas | |||
Ti Spotify URL para iti banag. | |||
pasurot | |||
banag | |||
Impormasion maipapan kadagiti pasurot ti artist. | |||
href | |||
kuerdas | |||
Nullable nga | |||
Daytoy ket kanayon a maikeddeng iti null, gapu ta ti Web API ket saan a mangsuporta daytoy iti agdama. | |||
dagup | |||
intero a bilang | |||
Ti dagup a bilang dagiti pasurot. | |||
dagiti genre | |||
array ti kuerdas | |||
Listaan dagiti genre a nakainaigan ti artist. No saan pay a naklase, ti array ket awan ti kargana. | |||
Pagwadan :["Prog rock","Grunge"] | |||
href | |||
kuerdas | |||
Ti silpo iti Web API endpoint a mangipaay kadagiti naan-anay a detalye ti artista. | |||
id | |||
kuerdas | |||
Ti Spotify ID para iti artist. | |||
dagiti ladawan | |||
array ti ImageObject | |||
Dagiti ladawan ti artist iti nadumaduma a kadakkel, kalawaan nga umuna. | |||
nagan | |||
kuerdas | |||
Ti nagan ti artista. | |||
kinalatak | |||
intero a bilang | |||
Ti kinalatak ti artist. Ti pateg ket addanto iti nagbaetan ti 0 ken 100, a ti 100 ti kalatakan. Makuenta ti kinalatak ti artist manipud iti kinalatak ti amin a track ti artist. | |||
tipo | |||
kuerdas | |||
Ti kita ti banag. | |||
Dagiti maipalubos a pateg: "artist" | |||
uri | |||
kuerdas | |||
Ti Spotify URI para iti artista. | |||
Bagay ti Track | |||
banag | |||
album | |||
banag | |||
Ti album a pagparangan ti track. Ti banag ti album ket mangiraman ti silpo hrefiti naan-anay nga impormasion maipapan ti album. | |||
album_tipo ti album | |||
kuerdas | |||
Kasapulan | |||
Ti kita ti album. | |||
Dagiti maipalubos a pateg: , , . "album""single""compilation" | |||
Pagwadan :"compilation" | |||
total_tracks ti dagup | |||
intero a bilang | |||
Kasapulan | |||
Ti bilang dagiti track iti album. | |||
Pagwadan :9 | |||
dagiti magun-od_a_merkado | |||
array ti kuerdas | |||
Kasapulan | |||
Dagiti merkado a ti album ket magun-od: ISO 3166-1 alpha-2 a kodigo ti pagilian . NOTE : ti album ket maibilang a magun-od iti maysa a merkado no di kumurang a 1 kadagiti trackna ti magun-odan iti dayta a merkado. | |||
Pagwadan :["CA","BR","IT"] | |||
dagiti_url iti ruar | |||
banag | |||
Kasapulan | |||
Dagiti ammo nga akinruar nga URL para iti daytoy nga album. | |||
spotify ti panagkita | |||
kuerdas | |||
Ti Spotify URL para iti banag. | |||
href | |||
kuerdas | |||
Kasapulan | |||
Ti silpo iti Web API endpoint a mangipaay kadagiti naan-anay a detalye ti album. | |||
id | |||
kuerdas | |||
Kasapulan | |||
Ti Spotify ID para iti album. | |||
Pagwadan :"2up3OPMp9Tb4dAKM2erWXQ" | |||
dagiti ladawan | |||
array ti ImageObject | |||
Kasapulan | |||
Ti cover art para iti album iti nadumaduma a kadakkel, kalawaan nga umuna. | |||
nagan | |||
kuerdas | |||
Kasapulan | |||
Ti nagan ti album. No ti album takedown, ti pateg ket mabalin nga empty string. | |||
petsa_ti_panangiruar | |||
kuerdas | |||
Kasapulan | |||
Ti petsa nga immuna a pannakairuar ti album. | |||
Pagwadan :"1981-12" | |||
presision ti petsa_ti_panangiruar | |||
kuerdas | |||
Kasapulan | |||
Ti eksakto a release_datepannakaammo ti pateg. | |||
Dagiti maipalubos a pateg: , , . "year""month""day" | |||
Pagwadan :"year" | |||
dagiti restriksion | |||
banag | |||
Nairaman iti sungbat no maipakat ti restriksion ti linaon. | |||
tipo | |||
kuerdas | |||
Kasapulan | |||
Ti kita ti banag. | |||
Dagiti maipalubos a pateg: "album" | |||
uri | |||
kuerdas | |||
Kasapulan | |||
Ti Spotify URI para iti album. | |||
Pagwadan :"spotify:album:2up3OPMp9Tb4dAKM2erWXQ" | |||
dagiti artista | |||
urnos ti SimplifiedArtistObject | |||
Kasapulan | |||
Dagiti artista ti album. Tunggal banag ti artista ket mangiraman ti silpo hrefiti ad-adu a detalyado nga impormasion maipapan ti artista. | |||
dagiti artista | |||
array ti ArtistObject | |||
Dagiti artista a nangipabuya iti track. Tunggal banag ti artista ket mangiraman ti silpo hrefiti ad-adu a detalyado nga impormasion maipapan ti artista. | |||
dagiti magun-od_a_merkado | |||
array ti kuerdas | |||
Ti listaan dagiti pagilian a mabalin a maipatokar ti track, a nailasin babaen ti ISO 3166-1 nga alpha-2 a kodigoda. | |||
numero_ti_disco | |||
intero a bilang | |||
Ti numero ti disk (kadawyan 1malaksid no ti album ket buklen ti nasurok a maysa a disc). | |||
kapaut_ms | |||
intero a bilang | |||
Ti kaatiddog ti track iti milisegundos. | |||
nalawag | |||
boolean nga | |||
No ti track ket addaan wenno awan kadagiti nalawag a liriko ( true= wen adda; false= saan ket awan WENNO saan nga ammo). | |||
dagiti_id_ti_ruar | |||
banag | |||
Ammo nga external IDs para iti track. | |||
isrc | |||
kuerdas | |||
Internasional a Pagalagadan a Kodigo ti Panagrekord | |||
ean | |||
kuerdas | |||
Internasional a Numero ti Artikulo | |||
upc | |||
kuerdas | |||
Sapasap a Kodigo ti Produkto | |||
dagiti_url iti ruar | |||
banag | |||
Dagiti ammo nga akinruar nga URL para iti daytoy a pagsurotan. | |||
spotify ti panagkita | |||
kuerdas | |||
Ti Spotify URL para iti banag. | |||
href | |||
kuerdas | |||
Ti silpo iti Web API endpoint a mangipaay kadagiti naan-anay a detalye ti pagsurotan. | |||
id | |||
kuerdas | |||
Ti Spotify ID para iti track. | |||
ket_maay-ayam | |||
boolean nga | |||
Paset ti sungbat no maipakat ti Track Relinking . No true, ti track ket maipatokar iti naited a merkado. Maipapan ti sabali false. | |||
naisilpo_manipud | |||
banag | |||
Paset ti sungbat no maipakat ti Track Relinking , ken ti kiniddaw a track ket nasukatan iti sabali a track. Ti track iti linked_frombanag ket aglaon ti impormasion maipapan ti orihinal a kiniddaw a track. | |||
dagiti restriksion | |||
banag | |||
Nairaman iti sungbat no maipakat ti restriksion ti linaon. | |||
rason | |||
kuerdas | |||
Ti rason ti pannakaiparit. Dagiti nasuportaran a pateg: | |||
market- Ti content item ket saan a magun-od iti naited a merkado. | |||
product- Ti linaon a banag ket saan a magun-od para iti kita ti suskrision ti agar-aramat. | |||
explicit- Ti banag ti linaon ket nalawag ken ti account ti agar-aramat ket naikeddeng a saan nga agay-ayam ti nalawag a linaon. | |||
Mabalin a mainayon dagiti kanayonan a rason iti masanguanan. Pakaammo : No usarem daytoy a tay-ak, siguraduem a ti aplikasionmo ket sitatalged a mangasikaso kadagiti di ammo a pateg. | |||
nagan | |||
kuerdas | |||
Ti nagan ti track. | |||
kinalatak | |||
intero a bilang | |||
Ti kinalatak ti track. Ti pateg ket addanto iti nagbaetan ti 0 ken 100, a ti 100 ti kalatakan. | |||
Ti kinalatak ti maysa a track ket pateg iti nagbaetan ti 0 ken 100, nga adda ti 100 a kalatakan. Ti kinalatak ket nakuenta babaen ti algoritmo ken naibatay, iti kaaduan a paset, iti dagup a bilang dagiti pabuya a naaddaan ti track ken no kasano ti kabarbaro dagita a pabuya. | |||
Iti sapasap a panagsao, dagiti kanta nga adu ti maipatokar ita ket dakdakkelto ti kinalatakda ngem dagiti kanta nga adu ti maipatokar idi un-unana. Dagiti naduplikado a track (kas pagarigan ti isu met laeng a track manipud iti maymaysa ken maysa nga album) ket na-rate nga agwaywayas. Ti kinalatak ti artist ken album ket nagtaud iti matematika manipud iti kinalatak ti track. Pakaammo : ti pateg ti kinalatak ket mabalin a naud-udi ti aktual a kinalatak iti sumagmamano nga aldaw: ti pateg ket saan a na-update iti aktual nga oras. | |||
preview_url ti umuna | |||
kuerdas | |||
Nullable nga | |||
Maysa a silpo iti 30 a segundo a preview (MP3 format) ti track. Mabalin a kastanull | |||
Napateg a nota ti patakaran | |||
Dagiti Spotify Audio preview clips ket saan a mabalin nga agmaymaysa a serbisio | |||
Mabalin a saan a maitukon dagiti Audio Preview Clips kas agmaymaysa a serbisio wenno produkto. | |||
Ad-adu pay nga impormasion | |||
numero_ti_track | |||
intero a bilang | |||
Ti numero ti track. No ti maysa nga album ket addaan iti sumagmamano a disc, ti numero ti track ket isu ti numero iti naikeddeng a disc. | |||
tipo | |||
kuerdas | |||
Ti kita ti banag: "track". | |||
Dagiti maipalubos a pateg: "track" | |||
uri | |||
kuerdas | |||
Ti Spotify URI para iti track. | |||
ket_lokal | |||
boolean nga | |||
No ti track ket manipud iti lokal a file wenno saan. | |||
PUNTO TI PANAGPATINGGA | |||
https://api.spotify.com/v1/siak/ngato/{tipo} | |||
tipo | |||
dagiti artista | |||
oras_a_range | |||
kalalainganna_ti_panawen | |||
limitasion | |||
10 | |||
offset ti | |||
5. 5 | |||
AGKIDDAW ITI SAMPLE | |||
cURL | |||
Wget | |||
HTTPie nga | |||
curl --request GET \ | |||
--url https://api.spotify.com/v1/me/top/artists \ | |||
--header 'Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z' | |||
SAMPLE TI SUNGBAT | |||
{ | |||
" href ": " https://api.spotify.com/v1/siak/ipakitana?offset=0&limit=20 " , | |||
" limitasion ": 20 , . | |||
" sumaruno ": " https://api.spotify.com/v1/siak/ipakitana?offset=1&limit=1 " , | |||
" offset ": 0 , . | |||
" napalabas ": " https://api.spotify.com/v1/siak/ipakitana?offset=1&limit=1 " , | |||
" dagup ": 4 , . | |||
" dagiti banag ": [ | |||
{ | |||
" dagiti_url_ti_ruar ": { | |||
" spotify ": " kuerdas " . | |||
} , . | |||
" dagiti pasurot ": { | |||
" href ": " kuerdas " , . | |||
" dagup ": 0 | |||
} , . | |||
" henero ": [ " Prog rock " , " Grunge " ] , . | |||
" href ": " kuerdas " , . | |||
" id ": " kuerdas " , . | |||
" dagiti ladawan ": [ | |||
{ | |||
" url ": " https://i.scdn.co/ladawan/ab67616d00001e02ff9ca10b55ce82ae553c8228 " , | |||
" kangato ": 300 , . | |||
" kalawa ": 300 | |||
} . | |||
] , . | |||
" nagan ": " kuerdas " , . | |||
" kinalatak ": 0 , . | |||
" tipo ": " artista " , . | |||
" uri ": " kuerdas " . | |||
} . | |||
] | |||
} . | |||
I-click ditoy tapno makita ti maitutop a dokumentasion | |||
Dakami ken dagiti kasosyomi ket agus-usar kadagiti cookies tapno maipersonal ti padasmo, tapno maipakita kenka dagiti anunsio a naibatay kadagiti interesmo, ken para kadagiti panggep ti panagrukod ken panaganalisar. Babaen ti panangusar iti website ken serbisiomi, umanamongka iti panangusarmi kadagiti cookies kas nailadawan iti Pagannurotanmi iti Cookie. | |||
Code | |||
JS | |||
[[JavaScript]] | |||
// Authorization token that must have been created previously. See : https://developer.spotify.com/documentation/web-api/concepts/authorization | |||
const token = 'BQDTxN1Whfd_b5hDY3_WfKeDsTCKNhBj2HUp7XNeV47tkiAQ7JGVTNMyr94xBvnubvutMl-6jTdzEbhPxECOxJUbS6JoG8cbbGy4Fmhlktl97R6QlxM3qzRTa-tfpKCuS9HuECEHF5E8c4PVxwsM55hkBclh6N1uKD3etEtFhGmQanO3TcOcQPIygZqnlmhcNQnONQy4Cuyex3AiJB3-C9c2165IuUaSjdB4-G9XlXDRvrLMhnOpVojYQDjJTQBLAHTcbxEi3W8H7hyrNJ-kY2cv'; | |||
async function fetchWebApi(endpoint, method, body) { | |||
const res = await fetch(`https://api.spotify.com/${endpoint}`, { | |||
headers: { | |||
Authorization: `Bearer ${token}`, | |||
}, | |||
method, | |||
body:JSON.stringify(body) | |||
}); | |||
return await res.json(); | |||
} | |||
async function getTopTracks(){ | |||
// Endpoint reference : https://developer.spotify.com/documentation/web-api/reference/get-users-top-artists-and-tracks | |||
return (await fetchWebApi( | |||
'v1/me/top/tracks?time_range=long_term&limit=5', 'GET' | |||
)).items; | |||
} | |||
const topTracks = await getTopTracks(); | |||
console.log( | |||
topTracks?.map( | |||
({name, artists}) => | |||
`${name} by ${artists.map(artist => artist.name).join(', ')}` | |||
) | |||
); | |||
Result | |||
Step 1: | |||
Get your top 5 tracks | |||
iFrame API | |||
Paraan | |||
window.onSpotifyIframeApiReady(object) | |||
Tukuyin ang pandaigdigang function na ito upang malaman ng iyong app kung kailan handa nang gamitin ang iFrame API. Nakatanggap ito ng isang bagay ( IFrameAPIsa aming halimbawa) na maaari mong gamitin upang lumikha ng mga controller. | |||
Mga Parameter | |||
Parameter Uri Paglalarawan | |||
IFrameAPI bagay Bagay na magagamit mo upang lumikha ng mga controller ng iFrame API | |||
Sample ng code | |||
window.onSpotifyIframeApiReady = (IFrameAPI) => { | |||
let element = document.getElementById('embed-iframe'); | |||
let options = { | |||
uri: 'spotify:episode:7makk4oTQel546B0PZlDM5' | |||
}; | |||
let callback = (EmbedController) => {}; | |||
IFrameAPI.createController(element, options, callback); | |||
}; | |||
IFrameAPI.createController [[Basaen Manen]]SOA@Calamriwn.com(element;ISO 38479</Translated> , options, callback) | |||
Tumawag createControllerpara sa bawat Embed na gusto mong iposisyon sa web page. | |||
Mga Parameter | |||
Parameter Uri Paglalarawan | |||
elemento bagay DOM element na gusto mong palitan ng Embed | |||
mga pagpipilian bagay Mga pares ng pangunahing halaga na nagko-configure sa bagong controller. Ang mga available na opsyon ay uri, ang Spotify URI ng content na gusto mong i-load muna; width, ang lapad sa pixel ng Embed, at height, ang taas sa pixel ng Embed. Tingnan ang sample sa ibaba para sa isang halimbawa. | |||
callback function Function na tumatanggap ng ginawang controller object ( EmbedController sa mga sumusunod na halimbawa) | |||
Sample ng code | |||
let element = document.getElementById(''embed-iframe'); | |||
let options = { | |||
width: 200, | |||
height: 400, | |||
uri: 'spotify:episode:7makk4oTQel546B0PZlDM5' | |||
}; | |||
let callback = (EmbedController) => {}; | |||
IFrameAPI.createController(element, options, callback); | |||
EmbedController.loadUri(spotifyUri) | |||
Gamitin ang paraang ito para mag-load ng bagong podcast episode sa isang Embed na iyong ginawa. | |||
Mga Parameter | |||
Parameter Uri Paglalarawan | |||
spotifyUri string String ng isang podcast episode URI na gusto mong i-load sa Embed | |||
preferVideo boolean Isang opsyonal na parameter upang i-play ang video ng isang podcast episode, kung available | |||
Magsimula sa numero Ang timestamp (sa mga segundo) mula sa kung saan dapat magsimula ang pag-playback kapag playtinawag ang pamamaraan | |||
Sample ng code | |||
EmbedController.loadUri('spotify:episode:7makk4oTQel546B0PZlDM5'); | |||
EmbedController.play() | |||
Ang pamamaraang ito ay magsisimulang i-play ang nilalaman na dati nang na-load. | |||
Sample ng code | |||
EmbedController.play(); | |||
EmbedController.pause() | |||
Ipo-pause ng paraang ito ang pag-playback. | |||
Sample ng code | |||
EmbedController.pause(); | |||
EmbedController.resume() | |||
Kung naka-pause ang playback, maaaring gamitin ang paraang ito para ipagpatuloy ito. Kung hindi sinimulan ang pag-playback, sisimulan ng paraang ito ang pag-playback. | |||
Sample ng code | |||
EmbedController.resume(); | |||
EmbedController.togglePlay() | |||
Ang pamamaraang ito ay nagpapalipat-lipat sa pagitan ng pag-play at pag-pause. | |||
Sample ng code | |||
EmbedController.togglePlay(); | |||
EmbedController.restart() | |||
Gamitin ang paraang ito upang i-restart ang pag-playback mula sa simula. | |||
Sample ng code | |||
EmbedController.restart(); | |||
EmbedController.seek(seconds) | |||
Gamitin ang paraang ito para maghanap sa isang partikular na punto sa podcast episode na na-load sa Embed. | |||
Mga Parameter | |||
Parameter Uri Paglalarawan | |||
segundo integer Ang bilang ng mga segundo sa podcast episode pagkatapos kung saan gusto mong ilipat ang cursor | |||
Sample ng code | |||
EmbedController.seek(200); | |||
EmbedController.destroy() | |||
Sinisira ang Embed at inaalis ang elemento ng DOM nito sa page. | |||
Sample ng code | |||
EmbedController.destroy(); | |||
Mga kaganapan | |||
ready | |||
Ang kaganapang ito ay gagana pagkatapos masimulan ang isang Embed at handa nang mag-stream ng nilalaman | |||
Sample ng code | |||
EmbedController.addListener('ready', () => { | |||
console.log('The Embed has initialized'); | |||
}); | |||
playback_update | |||
Ang kaganapang ito ay gagana pagkatapos magbago ang estado ng pag-playback. Maaaring mangyari ang mga pagbabago sa estado ng pag-playback sa pamamagitan ng pag-tap ng user sa mga kontrol sa pag-playback sa Embed, o sa pamamagitan ng program sa pamamagitan ng mga pamamaraan ng iFrame API, gaya ng seek() na paraan. | |||
Ang tagapangasiwa ng kaganapan ay makakatanggap ng isang bagay na may apat na katangian na naglalarawan sa kasalukuyang estado ng pag-playback: isPaused(bool), isBuffering(bool), duration(number) at position(number). durationinilalarawan ang haba ng na-load na episode ng podcast sa milisecond at positioninilalarawan ang lokasyon ng cursor sa milisecond. | |||
Sample ng code | |||
EmbedController.addListener('playback_update', e => { | |||
document.getElementById('progressTimestamp').innerText = `${parseInt(e.data.position / 1000, 10)} s`; | |||
}); | |||
Footer | |||
only apps that support language selection are shown here | |||
Revision as of 02:34, 30 June 2024
Dagiti plantilia a naus-usar iti daytoy a panid:
Voice Recorder>Sor.ly text<=/small>'Plantilia:Dakkel ( kitaen ti taudan ) (nasalakniban ti editor ti plantilia) Plantilia:C ( kitaen ti taudan ) (semi-nasalakniban) . Plantilia:C/display ( kitaen ti taudan ) (semi-nasalakniban) . Plantilia:Ilo ( kitaen ti taudan ) (nasalakniban) . Plantilia:Exp ( urnos ) . Plantilia:Ilawlawag ( urnosen ) . Plantilia:Kadakkel ti letra ( urnos ) . Plantilia:I-highlight ( i- edit ) . Plantilia:Marka ( urnosen ) . Plantilia:Overline ( urnosen ) . Plantilia:Baliwan ti kadakkel ( urnosen ) . Plantilia:Bassit ( kitaen ti taudan ) (semi-nasalakniban) . Plantilia:Small-caps ( kitaen ti taudan ) (semi-nasalakniban) . Plantilia:Small-caps/estilo.css ( urnosen ) . Plantilia:Bassit a sub ( urnos ) . Plantilia:Smallsup ( urnosen ) . Plantilia:Sub ( urnos ) . Plantilia:Sup sub ( urnos ) . Plantilia:T/kangrunaan ( kitaen ti taudan ) (nasalakniban) . Plantilia:Tl ( kitaen ti taudan ) (nasalakniban) . Plantilia:Tlx ( kitaen ti taudan ) (nasalakniban) . Plantilia:Pakdaar a karatula ( urnosen ) . Plantilia:Pakdaar ( urnos ) . Modulo:Core ( kitaen ti taudan ) (nasalakniban ti editor ti plantilia) . Modulo:Deskripsion ( kitaen ti taudan ) (nasalakniban ti editor ti plantilia) Lumaktaw sa nilalaman Saklaw Ang mga saklaw ay nagbibigay sa mga user ng Spotify na gumagamit ng mga third-party na app ng kumpiyansa na tanging ang impormasyong pipiliin nilang ibahagi ang ibabahagi, at wala nang iba pa.
Pre-requisites Kinakailangan ang mga saklaw kapag nagpapatupad ng ilan sa mga uri ng pagbibigay ng pahintulot. Tiyaking nabasa mo ang gabay sa Pagpapahintulot upang maunawaan ang mga pangunahing kaalaman.
Listahan ng mga Saklaw Mga imahe ugc-image-upload Spotify Connect user-read-playback-state user-modify-playback-state user-read-kasalukuyang-naglalaro Pag-playback app-remote-control streaming Mga playlist playlist-read-private playlist-read-collaborative playlist-modify-private playlist-modify-public Sundin user-follow-modify user-follow-read Kasaysayan ng Pakikinig user-read-playback-posisyon user-top-read user-read-recently-played Aklatan user-library-modify user-library-read Mga gumagamit user-read-email user-read-private Buksan ang Access user-soa-link user-soa-unlink soa-manage-entitlements soa-manage-partner soa-create-partner ugc-image-upload Paglalarawan Magsulat ng access sa mga larawang ibinigay ng user. Nakikita ng mga gumagamit Mag-upload ng mga larawan sa Spotify para sa iyo. Mga endpoint na nangangailangan ng ugc-image-uploadsaklaw
Magdagdag ng Custom na Playlist Cover Image user-read-playback-state Paglalarawan Basahin ang access sa status ng player ng isang user. Nakikita ng mga gumagamit Basahin ang iyong kasalukuyang nagpe-play na content at impormasyon ng mga device sa Spotify Connect. Mga endpoint na nangangailangan ng user-read-playback-statesaklaw
Kumuha ng Mga Available na Device ng User Kumuha ng Impormasyon Tungkol sa Kasalukuyang Pag-playback ng User Kunin ang Kasalukuyang Nagpe-play na Track ng User user-modify-playback-state Paglalarawan Magsulat ng access sa estado ng pag-playback ng isang user Nakikita ng mga gumagamit Kontrolin ang pag-playback sa iyong mga kliyente sa Spotify at mga Spotify Connect device. Mga endpoint na nangangailangan ng user-modify-playback-statesaklaw
I-pause ang Pag-playback ng User Maghangad na Puwesto Sa Kasalukuyang Nagpe-play ng Track Itakda ang Repeat Mode Sa Pag-playback ng User Itakda ang Volume Para sa Pag-playback ng User Laktawan ang Playback ng User Sa Susunod na Track Laktawan ang Playback ng User Sa Nakaraang Track Simulan/Ipagpatuloy ang Pag-playback ng User I-toggle ang Shuffle Para sa Pag-playback ng User Maglipat ng Playback ng User Magdagdag ng Item sa Dulo ng Kasalukuyang Playback Queue ng User user-read-currently-playing Paglalarawan Magbasa ng access sa kasalukuyang nagpe-play na content ng isang user. Nakikita ng mga gumagamit Basahin ang iyong kasalukuyang nagpe-play na nilalaman. Mga endpoint na nangangailangan ng user-read-currently-playingsaklaw
Kunin ang Kasalukuyang Nagpe-play na Track ng User Kunin ang Queue ng User app-remote-control Paglalarawan Remote control playback ng Spotify. Ang saklaw na ito ay kasalukuyang available sa Spotify iOS at Android SDK. Nakikita ng mga gumagamit Makipag-ugnayan sa Spotify app sa iyong device. Mga endpoint na nangangailangan ng app-remote-controlsaklaw
iOS SDK Android SDK streaming Paglalarawan Kontrolin ang pag-playback ng isang Spotify track. Ang saklaw na ito ay kasalukuyang available sa Web Playback SDK. Dapat ay mayroong Spotify Premium account ang user. Nakikita ng mga gumagamit Mag-play ng content at kontrolin ang pag-playback sa iba mo pang device. Mga endpoint na nangangailangan ng streamingsaklaw
Web Playback SDK playlist-read-private Paglalarawan Basahin ang access sa mga pribadong playlist ng user. Nakikita ng mga gumagamit I-access ang iyong mga pribadong playlist. Mga endpoint na nangangailangan ng playlist-read-privatesaklaw
Suriin kung Sinusundan ng Mga Gumagamit ang isang Playlist Kumuha ng Listahan ng Mga Kasalukuyang Playlist ng User Kumuha ng Listahan ng Mga Playlist ng User playlist-read-collaborative Paglalarawan Isama ang mga collaborative na playlist kapag humihiling ng mga playlist ng user. Nakikita ng mga gumagamit I-access ang iyong mga collaborative na playlist. Mga endpoint na nangangailangan ng playlist-read-collaborativesaklaw
Kumuha ng Listahan ng Mga Kasalukuyang Playlist ng User Kumuha ng Listahan ng Mga Playlist ng User playlist-modify-private Paglalarawan Magsulat ng access sa mga pribadong playlist ng user. Nakikita ng mga gumagamit Pamahalaan ang iyong mga pribadong playlist. Mga endpoint na nangangailangan ng playlist-modify-privatesaklaw
Sundin ang isang Playlist I-unfollow ang isang Playlist Magdagdag ng Mga Item sa isang Playlist Baguhin ang Mga Detalye ng Playlist Gumawa ng Playlist Alisin ang Mga Item mula sa isang Playlist Ayusin muli ang Mga Item ng Playlist Palitan ang Mga Item ng Playlist Mag-upload ng Custom na Playlist Cover Image playlist-modify-public Paglalarawan Magsulat ng access sa mga pampublikong playlist ng isang user. Nakikita ng mga gumagamit Pamahalaan ang iyong mga pampublikong playlist. Mga endpoint na nangangailangan ng playlist-modify-publicsaklaw
Sundin ang isang Playlist I-unfollow ang isang Playlist Magdagdag ng Mga Item sa isang Playlist Baguhin ang Mga Detalye ng Playlist Gumawa ng Playlist Alisin ang Mga Item mula sa isang Playlist Ayusin muli ang Mga Item ng Playlist Palitan ang Mga Item ng Playlist Mag-upload ng Custom na Playlist Cover Image user-follow-modify Paglalarawan Sumulat/magtanggal ng access sa listahan ng mga artist at iba pang user na sinusundan ng user. Nakikita ng mga gumagamit Pamahalaan kung sino ang iyong sinusundan. Mga endpoint na nangangailangan ng user-follow-modifysaklaw
Sundin ang Mga Artist o User I-unfollow ang Mga Artist o User user-follow-read Paglalarawan Basahin ang access sa listahan ng mga artist at iba pang user na sinusundan ng user. Nakikita ng mga gumagamit I-access ang iyong mga tagasunod at kung sino ang iyong sinusubaybayan. Mga endpoint na nangangailangan ng user-follow-readsaklaw
Tingnan kung Sinusubaybayan ng Kasalukuyang Gumagamit ang Mga Artist o Mga User Kunin ang mga Sinusubaybayang Artist ng User user-read-playback-position Paglalarawan Basahin ang access sa posisyon ng pag-playback ng user sa isang content. Nakikita ng mga gumagamit Basahin ang iyong posisyon sa nilalaman na iyong nilalaro. Mga endpoint na nangangailangan ng user-read-playback-positionsaklaw
Kumuha ng Episodes Kumuha ng Ilang Episode Kumuha ng isang Palabas Kumuha ng Ilang Palabas Kumuha ng Mga Episode ng Palabas user-top-read Paglalarawan Magbasa ng access sa mga nangungunang artist at track ng user. Nakikita ng mga gumagamit Basahin ang iyong mga nangungunang artist at nilalaman. Mga endpoint na nangangailangan ng user-top-readsaklaw
Kumuha ng Mga Nangungunang Artist at Track ng User user-read-recently-played Paglalarawan Magbasa ng access sa mga kamakailang na-play na track ng isang user. Nakikita ng mga gumagamit I-access ang iyong mga kamakailang na-play na item. Mga endpoint na nangangailangan ng user-read-recently-playedsaklaw
Kunin ang Mga Track ng Kasalukuyang Naglaro ng Kasalukuyang Gumagamit user-library-modify Paglalarawan Magsulat/magtanggal ng access sa library ng "Iyong Musika" ng user. Nakikita ng mga gumagamit Pamahalaan ang iyong naka-save na nilalaman. Mga endpoint na nangangailangan ng user-library-modifysaklaw
Alisin ang Mga Album para sa Kasalukuyang Gumagamit Alisin ang Mga Na-save na Track ng User Alisin ang Mga Na-save na Episode ng User I-save ang Mga Album para sa Kasalukuyang Gumagamit I-save ang Mga Track para sa User I-save ang Mga Episode para sa User user-library-read Paglalarawan Magbasa ng access sa library ng isang user. Nakikita ng mga gumagamit I-access ang iyong naka-save na nilalaman. Mga endpoint na nangangailangan ng user-library-readsaklaw
Suriin ang Mga Na-save na Album ng User Suriin ang Mga Na-save na Track ng User Kunin ang Mga Naka-save na Album ng Kasalukuyang User Kumuha ng Mga Na-save na Track ng User Suriin ang Mga Na-save na Episode ng User Kunin ang Mga Na-save na Episode ng User user-read-email Paglalarawan Basahin ang access sa email address ng user. Nakikita ng mga gumagamit Kunin ang iyong tunay na email address. Mga endpoint na nangangailangan ng user-read-emailsaklaw
Kunin ang Profile ng Kasalukuyang User user-read-private Paglalarawan Basahin ang access sa mga detalye ng subscription ng user (uri ng user account). Nakikita ng mga gumagamit I-access ang mga detalye ng iyong subscription. Mga endpoint na nangangailangan ng user-read-privatesaklaw
Maghanap ng isang Item Kunin ang Profile ng Kasalukuyang User user-soa-link Paglalarawan I-link ang isang partner na user account sa isang Spotify user account Mga endpoint na nangangailangan ng user-soa-linksaklaw
Magrehistro ng bagong user user-soa-unlink Paglalarawan I-unlink ang isang partner na user account mula sa isang Spotify account Mga endpoint na nangangailangan ng user-soa-unlinksaklaw
I-unlink ang user soa-manage-entitlements Paglalarawan Baguhin ang mga karapatan para sa mga naka-link na user Mga endpoint na nangangailangan ng soa-manage-entitlementssaklaw
Magdagdag ng mga karapatan ng user Kumuha ng mga karapatan ng user Inaalis ang mga karapatan ng user Palitan ang mga karapatan ng user soa-manage-partner Paglalarawan I-update ang impormasyon ng kasosyo Mga endpoint na nangangailangan ng soa-manage-partnersaklaw
Itakda ang logo ng kasosyo soa-create-partner Paglalarawan Lumikha ng mga bagong kasosyo, mga kasosyo sa platform lamang Mga endpoint na nangangailangan ng soa-create-partnersaklaw
Gumawa ng bagong partner Footer DOKUMENTASYON Web API Web Playback SDK Ads API iOS Android Mga naka-embed Komersyal na Hardware MGA ALITUNTUNIN Disenyo Accessibility KOMUNIDAD Balita Forum LEGAL Mga Tuntunin ng Developer Patakaran ng Developer Mga Tip sa Pagsunod Mga Lisensya ng Third Party Legal Mga cookies © 2024 Spotify AB
Kami at ang aming mga kasosyo ay gumagamit ng cookies upang i-personalize ang iyong karanasan, upang magpakita sa iyo ng mga ad batay sa iyong mga interes, at para sa mga layunin ng pagsukat at analytics. Sa pamamagitan ng paggamit ng aming website at mga serbisyo, sumasang-ayon ka sa aming paggamit ng cookies gaya ng inilarawan sa aming Patakaran sa Cookie. Laktawan ti linaon API ti Web • . Dagiti Reperensia / Dagiti Agus-usar / Alaen dagiti Nangato a Banag ti Agus-usar Alaen dagiti Nangruna a Banag ti Agus-usar
OAuth nga 2.0 Alaen dagiti kangrunaan nga artista wenno track ti agdama nga agar-aramat a naibatay iti nakuenta nga affinity.
Dagiti sakup ti autorisasion user-top-basaen ti agar-aramat Kiddaw
ALAN /siak/ngato/{tipo} Sungbat 200 nga 401 nga 403 nga 429 nga Panid dagiti artista wenno track
href kuerdas Kasapulan Ti silpo iti puntos ti panagpatingga ti Web API a mangisubli ti naan-anay a resulta ti kiddaw
Pagwadan :"https://api.spotify.com/v1/me/shows?offset=0&limit=20" limitasion intero a bilang Kasapulan Ti kangatuan a bilang dagiti banag iti sungbat (kas naikeddeng iti panagsaludsod wenno babaen ti default).
Pagwadan :20 sumaruno kuerdas Kasapulan Nullable nga URL iti sumaruno a panid dagiti banag. ( nullno awan) .
Pagwadan :"https://api.spotify.com/v1/me/shows?offset=1&limit=1" offset ti intero a bilang Kasapulan Ti offset dagiti banag a naisubli (kas naikeddeng iti panagsaludsod wenno babaen ti default) .
Pagwadan :0 napalabas kuerdas Kasapulan Nullable nga URL iti napalabas a panid dagiti banag. ( nullno awan) .
Pagwadan :"https://api.spotify.com/v1/me/shows?offset=1&limit=1" dagup intero a bilang Kasapulan Ti dagup a bilang dagiti banag a magun-odan nga isubli.
Pagwadan :4 dagiti banag array ti oneOfs Kasapulan Maysanto kadagiti sumaganad:
ArtistObject banag
dagiti_url iti ruar banag Dagiti ammo nga akinruar nga URL para iti daytoy nga artista.
spotify ti panagkita kuerdas Ti Spotify URL para iti banag.
pasurot
banag
Impormasion maipapan kadagiti pasurot ti artist.
href kuerdas Nullable nga Daytoy ket kanayon a maikeddeng iti null, gapu ta ti Web API ket saan a mangsuporta daytoy iti agdama.
dagup intero a bilang Ti dagup a bilang dagiti pasurot.
dagiti genre array ti kuerdas Listaan dagiti genre a nakainaigan ti artist. No saan pay a naklase, ti array ket awan ti kargana.
Pagwadan :["Prog rock","Grunge"] href kuerdas Ti silpo iti Web API endpoint a mangipaay kadagiti naan-anay a detalye ti artista.
id kuerdas Ti Spotify ID para iti artist.
dagiti ladawan
array ti ImageObject
Dagiti ladawan ti artist iti nadumaduma a kadakkel, kalawaan nga umuna.
nagan kuerdas Ti nagan ti artista.
kinalatak intero a bilang Ti kinalatak ti artist. Ti pateg ket addanto iti nagbaetan ti 0 ken 100, a ti 100 ti kalatakan. Makuenta ti kinalatak ti artist manipud iti kinalatak ti amin a track ti artist.
tipo kuerdas Ti kita ti banag.
Dagiti maipalubos a pateg: "artist" uri kuerdas Ti Spotify URI para iti artista.
Bagay ti Track
banag
album banag Ti album a pagparangan ti track. Ti banag ti album ket mangiraman ti silpo hrefiti naan-anay nga impormasion maipapan ti album.
album_tipo ti album kuerdas Kasapulan Ti kita ti album.
Dagiti maipalubos a pateg: , , . "album""single""compilation" Pagwadan :"compilation" total_tracks ti dagup intero a bilang Kasapulan Ti bilang dagiti track iti album.
Pagwadan :9 dagiti magun-od_a_merkado array ti kuerdas Kasapulan Dagiti merkado a ti album ket magun-od: ISO 3166-1 alpha-2 a kodigo ti pagilian . NOTE : ti album ket maibilang a magun-od iti maysa a merkado no di kumurang a 1 kadagiti trackna ti magun-odan iti dayta a merkado.
Pagwadan :["CA","BR","IT"]
dagiti_url iti ruar banag Kasapulan Dagiti ammo nga akinruar nga URL para iti daytoy nga album.
spotify ti panagkita kuerdas Ti Spotify URL para iti banag.
href kuerdas Kasapulan Ti silpo iti Web API endpoint a mangipaay kadagiti naan-anay a detalye ti album.
id kuerdas Kasapulan Ti Spotify ID para iti album.
Pagwadan :"2up3OPMp9Tb4dAKM2erWXQ"
dagiti ladawan array ti ImageObject Kasapulan Ti cover art para iti album iti nadumaduma a kadakkel, kalawaan nga umuna.
nagan kuerdas Kasapulan Ti nagan ti album. No ti album takedown, ti pateg ket mabalin nga empty string.
petsa_ti_panangiruar kuerdas Kasapulan Ti petsa nga immuna a pannakairuar ti album.
Pagwadan :"1981-12" presision ti petsa_ti_panangiruar kuerdas Kasapulan Ti eksakto a release_datepannakaammo ti pateg.
Dagiti maipalubos a pateg: , , . "year""month""day" Pagwadan :"year"
dagiti restriksion banag Nairaman iti sungbat no maipakat ti restriksion ti linaon.
tipo kuerdas Kasapulan Ti kita ti banag.
Dagiti maipalubos a pateg: "album" uri kuerdas Kasapulan Ti Spotify URI para iti album.
Pagwadan :"spotify:album:2up3OPMp9Tb4dAKM2erWXQ"
dagiti artista urnos ti SimplifiedArtistObject Kasapulan Dagiti artista ti album. Tunggal banag ti artista ket mangiraman ti silpo hrefiti ad-adu a detalyado nga impormasion maipapan ti artista.
dagiti artista
array ti ArtistObject
Dagiti artista a nangipabuya iti track. Tunggal banag ti artista ket mangiraman ti silpo hrefiti ad-adu a detalyado nga impormasion maipapan ti artista.
dagiti magun-od_a_merkado array ti kuerdas Ti listaan dagiti pagilian a mabalin a maipatokar ti track, a nailasin babaen ti ISO 3166-1 nga alpha-2 a kodigoda.
numero_ti_disco intero a bilang Ti numero ti disk (kadawyan 1malaksid no ti album ket buklen ti nasurok a maysa a disc).
kapaut_ms intero a bilang Ti kaatiddog ti track iti milisegundos.
nalawag boolean nga No ti track ket addaan wenno awan kadagiti nalawag a liriko ( true= wen adda; false= saan ket awan WENNO saan nga ammo).
dagiti_id_ti_ruar
banag
Ammo nga external IDs para iti track.
isrc kuerdas Internasional a Pagalagadan a Kodigo ti Panagrekord
ean kuerdas Internasional a Numero ti Artikulo
upc kuerdas Sapasap a Kodigo ti Produkto
dagiti_url iti ruar
banag
Dagiti ammo nga akinruar nga URL para iti daytoy a pagsurotan.
spotify ti panagkita kuerdas Ti Spotify URL para iti banag.
href kuerdas Ti silpo iti Web API endpoint a mangipaay kadagiti naan-anay a detalye ti pagsurotan.
id kuerdas Ti Spotify ID para iti track.
ket_maay-ayam boolean nga Paset ti sungbat no maipakat ti Track Relinking . No true, ti track ket maipatokar iti naited a merkado. Maipapan ti sabali false.
naisilpo_manipud
banag
Paset ti sungbat no maipakat ti Track Relinking , ken ti kiniddaw a track ket nasukatan iti sabali a track. Ti track iti linked_frombanag ket aglaon ti impormasion maipapan ti orihinal a kiniddaw a track.
dagiti restriksion
banag
Nairaman iti sungbat no maipakat ti restriksion ti linaon.
rason kuerdas Ti rason ti pannakaiparit. Dagiti nasuportaran a pateg:
market- Ti content item ket saan a magun-od iti naited a merkado. product- Ti linaon a banag ket saan a magun-od para iti kita ti suskrision ti agar-aramat. explicit- Ti banag ti linaon ket nalawag ken ti account ti agar-aramat ket naikeddeng a saan nga agay-ayam ti nalawag a linaon. Mabalin a mainayon dagiti kanayonan a rason iti masanguanan. Pakaammo : No usarem daytoy a tay-ak, siguraduem a ti aplikasionmo ket sitatalged a mangasikaso kadagiti di ammo a pateg.
nagan kuerdas Ti nagan ti track.
kinalatak intero a bilang Ti kinalatak ti track. Ti pateg ket addanto iti nagbaetan ti 0 ken 100, a ti 100 ti kalatakan. Ti kinalatak ti maysa a track ket pateg iti nagbaetan ti 0 ken 100, nga adda ti 100 a kalatakan. Ti kinalatak ket nakuenta babaen ti algoritmo ken naibatay, iti kaaduan a paset, iti dagup a bilang dagiti pabuya a naaddaan ti track ken no kasano ti kabarbaro dagita a pabuya. Iti sapasap a panagsao, dagiti kanta nga adu ti maipatokar ita ket dakdakkelto ti kinalatakda ngem dagiti kanta nga adu ti maipatokar idi un-unana. Dagiti naduplikado a track (kas pagarigan ti isu met laeng a track manipud iti maymaysa ken maysa nga album) ket na-rate nga agwaywayas. Ti kinalatak ti artist ken album ket nagtaud iti matematika manipud iti kinalatak ti track. Pakaammo : ti pateg ti kinalatak ket mabalin a naud-udi ti aktual a kinalatak iti sumagmamano nga aldaw: ti pateg ket saan a na-update iti aktual nga oras.
preview_url ti umuna kuerdas Nullable nga Maysa a silpo iti 30 a segundo a preview (MP3 format) ti track. Mabalin a kastanull
Napateg a nota ti patakaran Dagiti Spotify Audio preview clips ket saan a mabalin nga agmaymaysa a serbisio Mabalin a saan a maitukon dagiti Audio Preview Clips kas agmaymaysa a serbisio wenno produkto.
Ad-adu pay nga impormasion numero_ti_track intero a bilang Ti numero ti track. No ti maysa nga album ket addaan iti sumagmamano a disc, ti numero ti track ket isu ti numero iti naikeddeng a disc.
tipo kuerdas Ti kita ti banag: "track".
Dagiti maipalubos a pateg: "track" uri kuerdas Ti Spotify URI para iti track.
ket_lokal boolean nga No ti track ket manipud iti lokal a file wenno saan.
PUNTO TI PANAGPATINGGA https://api.spotify.com/v1/siak/ngato/{tipo} tipo dagiti artista oras_a_range kalalainganna_ti_panawen limitasion 10 offset ti 5. 5 AGKIDDAW ITI SAMPLE
cURL
Wget
HTTPie nga curl --request GET \
--url https://api.spotify.com/v1/me/top/artists \ --header 'Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z'
SAMPLE TI SUNGBAT {
" href ": " https://api.spotify.com/v1/siak/ipakitana?offset=0&limit=20 " , " limitasion ": 20 , . " sumaruno ": " https://api.spotify.com/v1/siak/ipakitana?offset=1&limit=1 " , " offset ": 0 , . " napalabas ": " https://api.spotify.com/v1/siak/ipakitana?offset=1&limit=1 " , " dagup ": 4 , . " dagiti banag ": [ { " dagiti_url_ti_ruar ": { " spotify ": " kuerdas " . } , . " dagiti pasurot ": { " href ": " kuerdas " , . " dagup ": 0 } , . " henero ": [ " Prog rock " , " Grunge " ] , . " href ": " kuerdas " , . " id ": " kuerdas " , . " dagiti ladawan ": [ { " url ": " https://i.scdn.co/ladawan/ab67616d00001e02ff9ca10b55ce82ae553c8228 " , " kangato ": 300 , . " kalawa ": 300 } . ] , . " nagan ": " kuerdas " , . " kinalatak ": 0 , . " tipo ": " artista " , . " uri ": " kuerdas " . } . ]
} . I-click ditoy tapno makita ti maitutop a dokumentasion Dakami ken dagiti kasosyomi ket agus-usar kadagiti cookies tapno maipersonal ti padasmo, tapno maipakita kenka dagiti anunsio a naibatay kadagiti interesmo, ken para kadagiti panggep ti panagrukod ken panaganalisar. Babaen ti panangusar iti website ken serbisiomi, umanamongka iti panangusarmi kadagiti cookies kas nailadawan iti Pagannurotanmi iti Cookie. Code JS JavaScript // Authorization token that must have been created previously. See : https://developer.spotify.com/documentation/web-api/concepts/authorization const token = 'BQDTxN1Whfd_b5hDY3_WfKeDsTCKNhBj2HUp7XNeV47tkiAQ7JGVTNMyr94xBvnubvutMl-6jTdzEbhPxECOxJUbS6JoG8cbbGy4Fmhlktl97R6QlxM3qzRTa-tfpKCuS9HuECEHF5E8c4PVxwsM55hkBclh6N1uKD3etEtFhGmQanO3TcOcQPIygZqnlmhcNQnONQy4Cuyex3AiJB3-C9c2165IuUaSjdB4-G9XlXDRvrLMhnOpVojYQDjJTQBLAHTcbxEi3W8H7hyrNJ-kY2cv'; async function fetchWebApi(endpoint, method, body) {
const res = await fetch(`https://api.spotify.com/${endpoint}`, { headers: { Authorization: `Bearer ${token}`, }, method, body:JSON.stringify(body) }); return await res.json();
}
async function getTopTracks(){
// Endpoint reference : https://developer.spotify.com/documentation/web-api/reference/get-users-top-artists-and-tracks return (await fetchWebApi( 'v1/me/top/tracks?time_range=long_term&limit=5', 'GET' )).items;
}
const topTracks = await getTopTracks(); console.log(
topTracks?.map(
({name, artists}) =>
`${name} by ${artists.map(artist => artist.name).join(', ')}`
)
); Result Step 1: Get your top 5 tracks
iFrame API Paraan window.onSpotifyIframeApiReady(object) Tukuyin ang pandaigdigang function na ito upang malaman ng iyong app kung kailan handa nang gamitin ang iFrame API. Nakatanggap ito ng isang bagay ( IFrameAPIsa aming halimbawa) na maaari mong gamitin upang lumikha ng mga controller.
Mga Parameter Parameter Uri Paglalarawan IFrameAPI bagay Bagay na magagamit mo upang lumikha ng mga controller ng iFrame API Sample ng code window.onSpotifyIframeApiReady = (IFrameAPI) => {
let element = document.getElementById('embed-iframe');
let options = {
uri: 'spotify:episode:7makk4oTQel546B0PZlDM5'
};
let callback = (EmbedController) => {};
IFrameAPI.createController(element, options, callback);
};
IFrameAPI.createController Basaen ManenSOA@Calamriwn.com(element;ISO 38479</Translated> , options, callback) Tumawag createControllerpara sa bawat Embed na gusto mong iposisyon sa web page.
Mga Parameter Parameter Uri Paglalarawan elemento bagay DOM element na gusto mong palitan ng Embed mga pagpipilian bagay Mga pares ng pangunahing halaga na nagko-configure sa bagong controller. Ang mga available na opsyon ay uri, ang Spotify URI ng content na gusto mong i-load muna; width, ang lapad sa pixel ng Embed, at height, ang taas sa pixel ng Embed. Tingnan ang sample sa ibaba para sa isang halimbawa. callback function Function na tumatanggap ng ginawang controller object ( EmbedController sa mga sumusunod na halimbawa) Sample ng code let element = document.getElementById(embed-iframe'); let options = {
width: 200, height: 400, uri: 'spotify:episode:7makk4oTQel546B0PZlDM5'
}; let callback = (EmbedController) => {}; IFrameAPI.createController(element, options, callback);
EmbedController.loadUri(spotifyUri) Gamitin ang paraang ito para mag-load ng bagong podcast episode sa isang Embed na iyong ginawa.
Mga Parameter Parameter Uri Paglalarawan spotifyUri string String ng isang podcast episode URI na gusto mong i-load sa Embed preferVideo boolean Isang opsyonal na parameter upang i-play ang video ng isang podcast episode, kung available Magsimula sa numero Ang timestamp (sa mga segundo) mula sa kung saan dapat magsimula ang pag-playback kapag playtinawag ang pamamaraan Sample ng code EmbedController.loadUri('spotify:episode:7makk4oTQel546B0PZlDM5');
EmbedController.play() Ang pamamaraang ito ay magsisimulang i-play ang nilalaman na dati nang na-load.
Sample ng code EmbedController.play();
EmbedController.pause() Ipo-pause ng paraang ito ang pag-playback.
Sample ng code EmbedController.pause();
EmbedController.resume() Kung naka-pause ang playback, maaaring gamitin ang paraang ito para ipagpatuloy ito. Kung hindi sinimulan ang pag-playback, sisimulan ng paraang ito ang pag-playback.
Sample ng code EmbedController.resume();
EmbedController.togglePlay() Ang pamamaraang ito ay nagpapalipat-lipat sa pagitan ng pag-play at pag-pause.
Sample ng code EmbedController.togglePlay();
EmbedController.restart() Gamitin ang paraang ito upang i-restart ang pag-playback mula sa simula.
Sample ng code EmbedController.restart();
EmbedController.seek(seconds) Gamitin ang paraang ito para maghanap sa isang partikular na punto sa podcast episode na na-load sa Embed.
Mga Parameter Parameter Uri Paglalarawan segundo integer Ang bilang ng mga segundo sa podcast episode pagkatapos kung saan gusto mong ilipat ang cursor Sample ng code EmbedController.seek(200);
EmbedController.destroy() Sinisira ang Embed at inaalis ang elemento ng DOM nito sa page.
Sample ng code EmbedController.destroy();
Mga kaganapan ready Ang kaganapang ito ay gagana pagkatapos masimulan ang isang Embed at handa nang mag-stream ng nilalaman
Sample ng code EmbedController.addListener('ready', () => {
console.log('The Embed has initialized');
});
playback_update Ang kaganapang ito ay gagana pagkatapos magbago ang estado ng pag-playback. Maaaring mangyari ang mga pagbabago sa estado ng pag-playback sa pamamagitan ng pag-tap ng user sa mga kontrol sa pag-playback sa Embed, o sa pamamagitan ng program sa pamamagitan ng mga pamamaraan ng iFrame API, gaya ng seek() na paraan.
Ang tagapangasiwa ng kaganapan ay makakatanggap ng isang bagay na may apat na katangian na naglalarawan sa kasalukuyang estado ng pag-playback: isPaused(bool), isBuffering(bool), duration(number) at position(number). durationinilalarawan ang haba ng na-load na episode ng podcast sa milisecond at positioninilalarawan ang lokasyon ng cursor sa milisecond.
Sample ng code EmbedController.addListener('playback_update', e => {
document.getElementById('progressTimestamp').innerText = `${parseInt(e.data.position / 1000, 10)} s`;
});
Footer only apps that support language selection are shown here