调用价格
1 匠币/次
快速接入
保持统一返回结构，直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/cookbook-typecURL 示例
curl --request POST \
--url 'https://openapi.toolkk.com/v1/cookbook-type' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/cookbook-type"
payload = {}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/cookbook-type"
payload := []byte("{}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 示例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/cookbook-type"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/cookbook-type';
$payload = "{}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;响应示例
[
"鸽子"
]示例用于理解返回结构，实际结果以接口返回为准。
- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
服务端调用时，将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求，并在 X-API-Key 请求头中传入密钥。
暂无字段定义，请参考 JSON 示例与接口说明。
请求示例
{}- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
响应字段
示例用于理解返回结构，实际结果以接口返回为准。
响应字段
字段来自接口结构定义。未提供的说明和示例会标为未标注。
| 字段路径 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| [] | string | 未标注 | 未标注 | 鸽子 |
响应示例
[
"鸽子"
]接口简介
接口能力、应用场景、使用限制与常见问题。
取得菜谱分类名称候选
接口返回菜谱分类名称组成的字符串数组，公开示例为鸽子。适合为内容标签或浏览筛选提供候选名称。当前请求定义没有业务筛选字段，结果不提供分类ID、父子关系、分类数量、菜谱详情或做法；应按名称列表理解，不能将字符串数组当作分类树或菜谱搜索结果。
编辑标签与浏览筛选
内容编辑器可以加载返回名称，供编辑选择后保存到自己的内容记录；菜谱浏览页面可以把名称显示为筛选候选，再由应用交给另一个已确认的检索流程；标签维护任务也可保存名称快照，与内部标签表比对新增和变化。是否分组、排序、合并别名及如何关联菜谱，均由调用方安排，接口没有自动执行这些整理动作。
按字符串数组读取结果
依据当前请求定义发起查询，取得结果后先确认顶层为数组，再逐项检查是否为字符串。将原始名称作为展示文本或业务候选值保留，遇到陌生名称也应兼容显示。若应用需要稳定主键，可维护自己的映射，不能用数组位置作为长期ID。更新候选列表时先比较前后快照，避免名称变化导致历史内容标签被错误替换。
名称集合不说明层级与全集
当前没有确认分类全集、固定顺序、去重规则或更新时间，也没有承诺名称永久不变。不能从鸽子这一示例推导出所有食材、菜系、营养或功效分类。空数组、重复名称或缺少某类时，先区分调用异常与本次可用结果，再安排复核；业务可保留最近一次可用候选供降级使用，但不要补造返回值或把缺项当作不存在相关菜谱。
常见问题
需要传入分类关键词吗？
当前公开请求没有业务筛选字段。该接口用于取得名称候选，不能按其他菜谱服务的关键词、分类ID或父级参数调用。
能恢复一级、二级分类目录吗？
不能从当前结果直接恢复。字符串数组没有父子关系和层级字段，需要目录结构时，应另行维护并确认名称映射。
数组中的名称可以作为稳定ID吗？
当前没有稳定ID约定。应将名称用于展示或候选值，长期关联内容时维护自己的标识，并处理重名和名称变化。
选中分类后会自动返回菜谱吗？
不会。当前结果仅为名称列表；实际检索菜谱需要应用继续执行其他已确认的查询流程，不能把相邻接口能力并入此接口。