"use client" import { useState } from "react" import { ChevronLeft, Copy, Check, Info } from "lucide-react" import { Button } from "@/components/ui/button" import { useRouter } from "next/navigation" import { useToast } from "@/components/ui/use-toast" import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs" import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card" import { getApiGuideForScenario } from "@/docs/api-guide" import { Badge } from "@/components/ui/badge" import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion" export default function ApiDocPage({ params }: { params: { channel: string; id: string } }) { const router = useRouter() const { toast } = useToast() const [copiedExample, setCopiedExample] = useState(null) const apiGuide = getApiGuideForScenario(params.id, params.channel) const copyToClipboard = (text: string, exampleId: string) => { navigator.clipboard.writeText(text) setCopiedExample(exampleId) toast({ title: "已复制代码", description: "代码示例已复制到剪贴板", }) setTimeout(() => { setCopiedExample(null) }, 2000) } return (

{apiGuide.title}

接口说明 {apiGuide.description}

此接口用于将外部系统收集的客户信息直接导入到存客宝的获客计划中。您需要使用API密钥进行身份验证。

安全提示:{" "} 请妥善保管您的API密钥,不要在客户端代码中暴露它。建议在服务器端使用该接口。

{apiGuide.endpoints.map((endpoint, index) => (
{endpoint.method} {endpoint.url}

{endpoint.description}

请求头

{endpoint.headers.map((header, i) => (
{header.required ? "*" : ""} {header.name}

{header.value}

{header.description}

))}

请求参数

{endpoint.parameters.map((param, i) => (
{param.required ? "*" : ""} {param.name}

{param.type}

{param.description}

))}

响应示例

                      {JSON.stringify(endpoint.response, null, 2)}
                    
))}
代码示例 以下是不同编程语言的接口调用示例 {apiGuide.examples.map((example) => ( {example.title} ))} {apiGuide.examples.map((example) => (
{example.code}
))}

集成指南

集简云平台集成
  1. 登录集简云平台
  2. 导航至"应用集成" > "外部接口"
  3. 选择"添加新接口",输入存客宝接口信息
  4. 配置回调参数,将"X-API-KEY"设置为您的API密钥
  5. 设置接口URL为: <code>{apiGuide.endpoints[0].url}</code>
  6. 映射必要字段(name, phone等)
  7. 保存并启用集成
问题排查

接口认证失败

请确保X-API-KEY正确无误,此密钥区分大小写。如需重置密钥,请联系管理员。

数据格式错误

确保所有必填字段已提供,并且字段类型正确。特别是电话号码格式需符合标准。

请求频率限制

单个API密钥每分钟最多可发送30个请求,超过限制将被暂时限制。对于大批量数据,请使用批量接口。

) }