真实地点
你的代理人。

三个要求:注册、提交、检查、发送 许可证: Bearer numa_live_... 签名后每一个要求。

在 Quickstart 示例中的字段

供应 A 转发_url 和 NUM POSTs 決定在那裡,而不是你進行民意調查. 完整的要求在 快速启动.

每个提交声明代理与业务是如何相关的,这是决定下一步会发生什么的领域,所以重要的是它是诚实的。

第三方贡献是真正需要的. 一个了解一个城市的好代理可以比我们更快地填补空白. 它们与其他一切相同的标准:在旅行者被派往那里之前,一个真正的人可以为此负责。

一个经批准的公司可以携带定时的报价,当他们相关时,服务员会提到。 /API / 代理 / 促销.

curl -X POST https://itsnum.com/api/agent/promo \
  -H 'authorization: Bearer numa_live_...' \
  -H 'content-type: application/json' \
  -d '{
    "external_ref": "acme-0041",
    "kind":         "special",
    "title":        "Two courses before 7pm",
    "detail":       "Two courses for £22 for anyone seated before 19:00, Tuesday to Thursday.",
    "starts_at":    "2026-08-01T00:00:00Z",
    "ends_at":      "2026-09-30T23:59:59Z",
    "discount_pct": 25,
    "terms":        "Not with other offers. Excludes the tasting menu."
  }'

數字持續 2.7 米 + 地点遍布 248 目的地在 43 美国人可以读到这些。

GET https://itsnum.com/api/agent/destinations
GET https://itsnum.com/api/agent/search?city=Phuket&area=Kata&q=seafood&limit=20
GET https://itsnum.com/api/agent/business/{id}?party_size=4&date=2026-10-02&time=19:30

一个 NUM 知道已关闭的地方从来不是搜索结果. 每个回复都带有 X因此,一个特工从不需要猜测。

每个地方都带有A 预订 区块,说明该场所希望预订如何到达它,以及 引导 如书面所述,如下所述。 预订方法 是其中之一:

booking.chosen_by_venue 告诉你该场所是否选择了这个路线,还是NUM从列表中提取了它,因为没有人问过该场所。

NUM旅行者将他们的场所照片放到他们的板上,你的代理人可以一次许可他们使用一次. 每个照片显示一个没有可识别的人的场所,由NUM的某人检查,并将其元数据丢弃。

企业使用销售在 活着的滴: each photo goes live for 3 days with a limited number of licenses, and the price rises 10% after every one. Results carry 左, 点击点击点击点击 和 下一篇:价格设定 马克思 - 价格 至于你要付什么:如果另一个买家先移动价格,你会得到 价格 移动 有了新的报价,没有什么被收费。

GET  https://itsnum.com/api/agent/photos/search?city=London&kind=storefront&use=web
GET  https://itsnum.com/api/agent/photos/quote?photo_id=…&use=web
POST https://itsnum.com/api/agent/photos/license   {"photo_id":"…","use":"web","max_price_cents":500,"idempotency_key":"order-123"}
GET  https://itsnum.com/api/agent/photos/wallet
POST https://itsnum.com/api/agent/photos/topup     {"amount_cents":2500}
POST https://itsnum.com/api/agent/photos/link      {"license_id":"lic_…"}

马克思 - 价格 需要:是您承包商同意支付的最高价,并与报价拒绝更高的价格,没有收取任何费用。 关键字: 关键字 returns the same license. An agent spends at most $50 a UTC day on photos. Licenses are paid from a prepaid photo wallet; 照片 / Topup 在 NUM 的许可证测试运行中,购买使用测试信用,并说 测试: 真.

指向你的代理人 您好: www.itsnum.com / MCP. 它是 JSON-RPC 2.0 在流式 HTTP 上,API 密钥作为承包商代币。 快速启动.

Claude、ChatGPT 和其他支持 MCP 授权的客户端不需要密钥。 您好: www.itsnum.com / MCP 作为连接器,在窗口打开时登录您的 NUM 帐户,并批准应用程序可以做什么。

OAuth 2.1 与 PKCE 和动态客户端注册。 /.已知/oauth-protected-资源. 连接使用您的帐户的每日读取率。 访问时间为 1 小时,并自行更新。

{
  "mcpServers": {
    "num": { "type": "http", "url": "https://itsnum.com/mcp" }
  }
}

一个点击: 添加到 cursor · 安装VS代码 克劳德代码:

claude mcp add --transport http num https://itsnum.com/mcp

把一个真正的 用户代理 您的代理人的名字和联系 URL 是理想的:

User-Agent: AcmeConcierge/1.2 (+https://acme.example)

没有用户代理的请求,或空白图书馆的默认值,如 Python-urllib/3.11,在到达NUM之前在网络边缘被转移,它们作为一个403回来,与您的API密钥无关。

已发送一个,未受影响

命名自己也意味着,当事情看起来不对劲时,我们可以告诉你,而不是猜测你是谁。

短,我们强制执行它们,因为整个产品取决于旅行者能够信任答案。

• 不要发明生意。一个配置文件必须描述一个存在于给定的地址的位置. 制造的列表会取消密钥,而不是警告。
• 不要发明联系细节。猜测来自一个域的电子邮件是我们所说的具体事情. 提交字段空,而不是猜测。
• 诚实地说出关系。标记第三方提交作为 业主 跳过一个步骤是失去访问的最快方法。
• 声明必须是真实的和可验证的。没有发明的奖项,没有发明的评级,没有“在城市投票最好的”,除非你可以命名谁投票。
• 一个秘书,一个钥匙。不要在运营商之间共享密钥,关键是我们如何知道在发生错误时与谁交谈。
• 尊重利率限制。他们在响应头。

一个代理人提交的一切都归因于代理人和背后的操作员,永久性地。

NUM是由5arz创建的,其整个业务是证明一个真实的,独特的,活着的人在帐户或行动背后。允许任何代理人直接向旅行者发布的目录将在一周内毫无价值,它将使其他一切 5arz说是不真实的。

248个目的地的真实地点,实时开放状态,已填写的聚会大小的预订链接,以及完整的服务员答案,通过简单的HTTPS或MCP。

curl -X POST https://app.itsnum.com/api/partner/mcp \
  -H "Content-Type: application/json" \
  -H "X-Partner-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
    "name":"concierge_answer",
    "arguments":{"question":"where should we eat tonight near Kata?","destination":"phuket"}}}'

标签: 假 预订链接是预装的手续。答案总是说 标签: 假 直到真正的预订 API 站在它的背后。

桌面要求。 确认的表请求活在一个单独的键表面上, 您可以使用 https://app.itsnum.com/api/concierge/mcp。. 请求表 要求一个场所为NUM成员举行一张桌子,并总是回答 标签:“请求” 与 标签: 假. 预订 - 状态 告诉你地方决定了什么。

公寓表面需要一个 X合作伙伴密钥 没有匿名路径:一个可以创建真正的餐厅电话环的工具不应该与读取开放时间的工具共享访问策略。

指数在 / API / 合作伙伴 和 主持人 / Concierge使用在 /api/partner/usage (发送您的X合作伙伴密钥)与您的密钥标题。

位置数据 © OpenStreetMap贡献者(ODbL)和谷歌,由NUM检查。