> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# 快速入门

用 curl 或 Python 发起你的第一次 Anysite API 调用。

目标：通过 REST API 获取一个 LinkedIn 个人资料。

  
#### 拥有有效套餐

    每次调用都需要有效套餐中的积分。参见[套餐与积分](/docs/plans-and-credits?lang=zh)。
    

> ACTION FOR THE HUMAN: open https://app.anysite.io/billing?tab=plans (查看套餐).

  
  
#### 调用一个端点

    每个端点都是 `https://api.anysite.io/api/<endpoint path>`，用 `access-token` 请求头认证。
    参数放在 JSON 请求体中。

    

    ```bash cURL
    curl --max-time 1600 -X POST "https://api.anysite.io/api/linkedin/user" \
      -H "access-token: YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"user": "satyanadella"}'
    ```

    > ACTION FOR THE HUMAN: copy your API key at https://app.anysite.io/billing — an agent cannot obtain it.

    ```python Python
    import requests

    response = requests.post(
        "https://api.anysite.io/api/linkedin/user",
        headers={"access-token": "YOUR_API_KEY"},
        json={"user": "satyanadella"},
        timeout=1600,
    )
    print(response.status_code, response.headers.get("x-credits-charged"))
    print(response.json())
    ```

    > ACTION FOR THE HUMAN: copy your API key at https://app.anysite.io/billing — an agent cannot obtain it.

    
  

## 验证

- 状态码为 `200`，响应体是一个包含单个资料的 JSON **数组** —— 每个端点都以数组作答，包括返回单个
  实体的端点。
- 响应头 `x-credits-charged` 显示本次调用的花费，`x-token-points` 显示余额中剩余的积分。

## 如果失败

| 状态码 | 原因 |
|---|---|
| `422` | 缺少 `access-token` 请求头，或请求体不是 JSON 对象。 |
| `401` | 密钥无效、套餐已过期，或余额积分不足。 |
| `403` | 该密钥属于仅限 MCP 使用的套餐，不能调用 REST API。 |
| `412` | 该别名下的资料不存在，或该资料是私密的。响应体为 `[]`，原因在 `x-error` 响应头中。应先用搜索端点找到该人 —— `412` 会计费。 |

调用可能运行好几分钟，所以请像上面的示例那样，把 HTTP 客户端的超时设置为约 1600 秒。其他所有状态码
的说明见[错误与限制](/docs/errors-and-limits?lang=zh)。

## 下一步

- 在 [API 参考](/docs/api)中浏览所有端点及其参数。
- 或者连接一个 AI 客户端：[MCP 服务器](/docs/mcp/overview?lang=zh)。