加载中...

基础信息

查看接口基本信息和返回格式

免责声明

本平台提供的API服务均来自互联网,可能包含生成式AI内容。所有返回内容仅供参考,平台不对内容的准确性、完整性、时效性或适用性做任何保证。使用者应自行判断并承担使用风险。

温馨提示

歌单在线调试地址:<a href="https://api.yunmge.com/app-song_html.html">点击前往</a>

接口描述

为每位站长提供一个集成化的网站音乐播放器,可自定义歌单歌曲,助力发展!

七日请求统计
本周总请求: - 日均: -
请求方式
GET POST 推荐
请求地址
https://dome.api.yunmge.com/api/song_html
返回方式
JSON 默认返回格式,包含完整数据结构
TEXT 纯文本格式,适合简单数据返回
返回预览
JSON
TEXT
JSON
自行请求查看

计费标准

了解接口的计费方式和价格
付费接口定价
付费
每日免费 9
超出后计费
普通用户
额度消耗 1额度/次
余额扣费 0.01元/次
会员用户
调用费用 免费
QPS限制
普通用户
120
次/分钟
会员用户
999999
次/分钟
每日请求次数
普通用户
999999
次/天
会员用户
999999
次/天

安全认证

了解接口的认证方式和访问凭证管理
Token 认证

登录后可查看您的Token

立即登录
实名认证
无需实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
推荐 Header 认证

通过 HTTP Header 传递认证信息

Authorization
Bearer {access_token}

或通过curl请求参数传递:

curl
curl "https://dome.api.yunmge.com/api/song_html?token=YOUR_TOKEN"

参数文档

查看接口请求参数和返回字段说明
请求参数
参数名 类型 必填 默认值 可选值 说明
token string 必填 登录后显示你的请求token 接口请求唯一认证标识!
mode string 可选 json json(json歌单)、text(需要配合本站网站音乐播放器js使用) 返回类型
name string 可选 告白气球 歌曲名称
type string 必填 query add(添加)、del(删除)、query(查询)、delall(清空) 歌单操作,留空返回歌曲列表
mid string 可选 歌曲mid<br/>当type为add、del时必填<br/>(QQ音乐的mid,具体参考常见问题)
uid string 可选 用户token 歌单ID(大于6字符),本站会员专属自定义uid
返回参数
字段名 类型 说明
code
int 返回状态码
count
int 歌单歌曲数量
list
array 歌单列表
list.mid
string 歌曲mid
list.song
string 歌曲名称
list.singer
string 歌手
list.pic
string 封面
list.lrc
string 歌词
list.link
string 官方歌曲地址
list.pay
string 歌曲收费状态
list.time
string 歌曲时长
list.size
string 歌曲大小
list.url_mp3
string MP3音质歌曲链接
list.url_flac
string FLAC音质歌曲链接(本站会员专属)

状态码

了解接口返回的状态码含义及处理方式
接口状态码
状态码 说明
200 请求成功
351 多错误,具体请求查看
服务器状态码

示例代码

多种语言的接口调用示例
PHP
JavaScript
NodeJs
Python
Go
Java
C#
C
C++
易语言
PHP
<?php
$API_TOKEN = 'YOUR_TOKEN';
$API_URL = 'https://dome.api.yunmge.com/api/song_html';

$params = array(
    'token' => 'YOUR_TOKEN',
    'mode' => 'json',
    'name' => '告白气球',
    'type' => 'query',
    'mid' => '无',
    'uid' => '用户token',
);

$res = api::send($API_URL, $params, 'GET/POST');
print($res);

class api {
    public static function send($url, $data, $type) {
        $data = http_build_query($data);
        $ch = curl_init();
        if ($type == 'POST') {
            curl_setopt($ch, CURLOPT_URL, $url);
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        } else {
            curl_setopt($ch, CURLOPT_URL, $url . '?' . $data);
        }
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        $res = curl_exec($ch);
        curl_close($ch);
        return $res;
    }
}
JavaScript
$.ajax({
    url: 'https://dome.api.yunmge.com/api/song_html',
    data: {
        token: 'YOUR_TOKEN',
        mode: 'json',
        name: '告白气球',
        type: 'query',
        mid: '无',
        uid: '用户token',
    },
    type: 'GET/POST',
    dataType: 'json',
    success: function(data) {
        console.log(data);
    },
    error: function(err) {
        console.log('请求失败', err);
    }
});
Python
import requests

url = "https://dome.api.yunmge.com/api/song_html"
data = {
    "token": "YOUR_TOKEN",
    "mode": "json",
    "name": "告白气球",
    "type": "query",
    "mid": "无",
    "uid": "用户token",
}

response = requests.post(url, data=data)
print(response.json())
Java
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.*;

public class ApiRequest {
    public static void main(String[] args) throws Exception {
        URL url = new URL("https://dome.api.yunmge.com/api/song_html");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET/POST");
        conn.setConnectTimeout(10000);

        BufferedReader reader = new BufferedReader(
            new InputStreamReader(conn.getInputStream()));
        String line;
        StringBuilder result = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            result.append(line);
        }
        reader.close();
        System.out.println(result.toString());
    }
}
Go
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
"strings"
)

func main() {
    data := "token=YOUR_TOKEN&mode=json&name=%E5%91%8A%E7%99%BD%E6%B0%94%E7%90%83&type=query&mid=%E6%97%A0&uid=%E7%94%A8%E6%88%B7token"
    resp, _ := http.Post("https://dome.api.yunmge.com/api/song_html",
        "application/x-www-form-urlencoded", strings.NewReader(data))
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
C#
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        var data = new FormUrlEncodedContent(new Dictionary<string, string> {
            {"token", "YOUR_TOKEN"},
            {"mode", "json"},
            {"name", "告白气球"},
            {"type", "query"},
            {"mid", "无"},
            {"uid", "用户token"},
        });
        var response = await client.PostAsync("https://dome.api.yunmge.com/api/song_html", data);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(response);
    }
}
NodeJs
const https = require('https');
const querystring = require('querystring');

const postData = querystring.stringify({
    'token': 'YOUR_TOKEN',
    'mode': 'json',
    'name': '告白气球',
    'type': 'query',
    'mid': '无',
    'uid': '用户token',
});
const options = {
    hostname: 'dome.api.yunmge.com',
    path: '/api/song_html',
    method: 'POST',
    headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
};
const req = https.request(options, res => {
    let data = '';
    res.on('data', d => data += d);
    res.on('end', () => console.log(data));
});
req.write(postData);
req.end();
C
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>

static size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp) {
    ((char*)userp)[0] = '\0';
    strcat(userp, contents);
    return size * nmemb;
}

int main() {
    CURL *curl;
    CURLcode res;
    char response[4096] = {0};

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if(curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://dome.api.yunmge.com/api/song_html");
        curl_easy_setopt(curl, CURLOPT_POST, 1L);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json&name=%E5%91%8A%E7%99%BD%E6%B0%94%E7%90%83&type=query&mid=%E6%97%A0&uid=%E7%94%A8%E6%88%B7token");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, response);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);

        res = curl_easy_perform(curl);
        if(res == CURLE_OK) printf("%s\n", response);
        curl_easy_cleanup(curl);
    }
    curl_global_cleanup();
    return 0;
}
C++
#include <iostream>
#include <string>
#include <curl/curl.h>

size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* userp) {
    userp->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    std::string response;

    if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://dome.api.yunmge.com/api/song_html");
        curl_easy_setopt(curl, CURLOPT_POST, 1L);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "token=YOUR_TOKEN&mode=json&name=%E5%91%8A%E7%99%BD%E6%B0%94%E7%90%83&type=query&mid=%E6%97%A0&uid=%E7%94%A8%E6%88%B7token");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK) std::cout << response << std::endl;
        curl_easy_cleanup(curl);
    }
    curl_global_cleanup();
    return 0;
}
易语言
.版本 2
.支持库 spec

.局部变量 url, 文本型
.局部变量 params, 文本型
.局部变量 result, 文本型

url = "https://dome.api.yunmge.com/api/song_html"
params = "token=YOUR_TOKEN&mode=json&name=%E5%91%8A%E7%99%BD%E6%B0%94%E7%90%83&type=query&mid=%E6%97%A0&uid=%E7%94%A8%E6%88%B7token"

result = 编码_URL解码 (网页_访问 (url, , params))
调试输出 (result)

AI开发文档

导出接口文档供AI助手快速理解接口结构
复制下方内容粘贴给AI助手,即可快速生成对接代码。
JSON 格式 0 KB