语音通知 API 开发文档

<?php
// PHP 7.4+，需启用 cURL 扩展；仅在服务端运行。
$account = getenv('IHUYI_API_ID');
$password = getenv('IHUYI_API_KEY');
if (!$account || !$password) {
    throw new RuntimeException('请配置 IHUYI_API_ID 和 IHUYI_API_KEY');
}
$url = 'https://api.ihuyi.com/vm/Submit.json';
$data = [
    'account' => $account,
    'password' => $password,
    'mobile' => 'YOUR_TEST_MOBILE',
    'content' => '已审核模板对应的通知内容',
];
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($data),
    CURLOPT_HTTPHEADER => ['Content-Type: application/x-www-form-urlencoded'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
]);
$result = curl_exec($ch);
$error = curl_error($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($result === false) {
    throw new RuntimeException($error);
}
if ($status < 200 || $status >= 300) {
    throw new RuntimeException('HTTP ' . $status);
}
echo $result;
// 提交成功不等于呼叫成功，结果请结合回执判断。

// Java 11+；保存为 VoiceNotify.java，仅在服务端运行。
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.stream.Collectors;

public class VoiceNotify {
    public static void main(String[] args) throws Exception {
        String account = System.getenv("IHUYI_API_ID");
        String password = System.getenv("IHUYI_API_KEY");
        if (account == null || account.isBlank()
                || password == null || password.isBlank()) {
            throw new IllegalStateException("请配置 IHUYI_API_ID 和 IHUYI_API_KEY");
        }
        Map<String, String> data = new LinkedHashMap<>();
        data.put("account", account);
        data.put("password", password);
        data.put("mobile", "YOUR_TEST_MOBILE");
        data.put("content", "已审核模板对应的通知内容");
        String body = data.entrySet().stream()
            .map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8)
                + "=" + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
            .collect(Collectors.joining("&"));
        String url = "https://api.ihuyi.com/vm/Submit.json";
        HttpRequest request = HttpRequest.newBuilder(URI.create(url))
            .timeout(Duration.ofSeconds(10))
            .header("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();
        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10)).build();
        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8));
        if (response.statusCode() < 200 || response.statusCode() >= 300) {
            throw new IllegalStateException("HTTP " + response.statusCode());
        }
        System.out.println(response.body());
        // 提交成功不等于呼叫成功，结果请结合回执判断。
    }
}

// Node.js 22+，使用内置 fetch；仅在服务端运行。
async function main() {
  const { IHUYI_API_ID, IHUYI_API_KEY } = process.env;
  if (!IHUYI_API_ID || !IHUYI_API_KEY) {
    throw new Error('请配置 IHUYI_API_ID 和 IHUYI_API_KEY');
  }
  const url = 'https://api.ihuyi.com/vm/Submit.json';
  const body = new URLSearchParams({
    account: IHUYI_API_ID,
    password: IHUYI_API_KEY,
    mobile: 'YOUR_TEST_MOBILE',
    content: '已审核模板对应的通知内容',
  });
  const response = await fetch(url, {
    method: 'POST',
    body,
    signal: AbortSignal.timeout(10000),
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  console.log(await response.json());
  // 提交成功不等于呼叫成功，结果请结合回执判断。
}
main().catch(error => {
  console.error(error.message);
  process.exitCode = 1;
});

// Go 1.20+；仅在服务端运行。
package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "os"
    "strings"
    "time"
)

func main() {
    account, password := os.Getenv("IHUYI_API_ID"), os.Getenv("IHUYI_API_KEY")
    if account == "" || password == "" { panic("请配置 API ID 和 API KEY") }
    form := url.Values{
        "account": {account}, "password": {password},
        "mobile": {"YOUR_TEST_MOBILE"},
        "content": {"已审核模板对应的通知内容"},
    }
    req, err := http.NewRequest(http.MethodPost, "https://api.ihuyi.com/vm/Submit.json", strings.NewReader(form.Encode()))
    if err != nil { panic(err) }
    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    client := &http.Client{Timeout: 10 * time.Second}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    if resp.StatusCode < 200 || resp.StatusCode >= 300 { panic(resp.Status) }
    body, err := io.ReadAll(resp.Body)
    if err != nil { panic(err) }
    fmt.Println(string(body))
}

// .NET 8+；仅在服务端运行。
using System;
using System.Collections.Generic;
using System.Net.Http;

var account = Environment.GetEnvironmentVariable("IHUYI_API_ID")
    ?? throw new InvalidOperationException("请配置 API ID");
var password = Environment.GetEnvironmentVariable("IHUYI_API_KEY")
    ?? throw new InvalidOperationException("请配置 API KEY");
using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(10) };
using var body = new FormUrlEncodedContent(new Dictionary<string, string> {
    ["account"] = account, ["password"] = password,
    ["mobile"] = "YOUR_TEST_MOBILE",
    ["content"] = "已审核模板对应的通知内容"
});
using var response = await client.PostAsync("https://api.ihuyi.com/vm/Submit.json", body);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());