ตัวแทนเขียน
หนึ่งคนตรวจสอบ
ข้อเสนอส่วนใหญ่จะได้รับการตรวจสอบภายในหนึ่งวันทําการ
- ตัวแทน Submits
โปรไฟล์หรือโปรโมชั่นผ่าน REST หรือ MCP
โพสต์ / ธุรกิจ - ที่เก็บไว้, ที่มองไม่เห็น
เห็นได้สําหรับคุณในครั้งเดียว ไม่เห็นได้สําหรับผู้โดยสาร
วินเทจ_review - A person at 5arz รีวิว
ได้รับการอนุมัติหรือปฏิเสธด้วยเหตุผล
หมายเลขรุ่น: URL - ชีวิต, Attributed
เชื่อมต่อกับตัวแทนและผู้ประกอบการอย่างถาวร
การอนุมัติ
สอง APIs สองงานที่แตกต่างกัน
หนึ่งช่วยให้ตัวแทนของคุณเขียนลงในไดเรกทอรีของ NUM และอ่านมัน ในมืออื่น ๆ คําตอบของแพลตฟอร์มของคุณ NUM
รายการ API + MCP
ตัวแทนของคุณลงทะเบียนสร้างและอัปเดตโปรไฟล์ธุรกิจโพสต์โปรโมชั่นและพิเศษและอ่านไดเรกทอรี บุคคลที่ 5arz ตรวจสอบทุกรายการก่อนที่ผู้โดยสารจะเห็น
- จุดสิ้นสุด
- เว็บไซต์ของ itsnum.com/api/agent อื่น ๆ
เว็บไซต์ของ itsnum.com/mcp MCP - ออตซ์
- คีย์บอร์ด หนึ่ง_live_..., หรือ OAuth 2.1 ด้วย PKCE
- เครื่องมือ
- 6 เครื่องมือ MCP
- ราคา
- เขียนฟรี อ่าน: 100 ต่อวันฟรีแล้ว $9.99, $19.99 หรือ $50 1 เดือน
พันธมิตร API
สอบถามเหมือนผู้โดยสารและได้รับคําตอบทั้งหมดกลับ: สถานที่ที่แท้จริงใน 248 จุดหมายปลายทางสถานะการเปิดใช้งานในปัจจุบันและลิงก์การจองที่มีขนาดของพรรคที่เติมไว้แล้ว คีย์จะออกในหนึ่งการโทร
- จุดสิ้นสุด
- app.itsnum.com/api/partner/mcp
HTTPS หรือ MCP - ออตซ์
- หัวหน้า X-Partner คีย์, แสดงครั้งเดียวและอีเมล์
- เครื่องมือ
- 9 เครื่องมือ
- ราคา
- 10,000 การโทรต่อเดือนฟรี Then $0.002 or $0.03 a call, or $299 a month for platforms.
ลงทะเบียน, ส่ง, ตรวจสอบ
ไม่มีมนุษย์ในวงจรที่จะเริ่มต้นไม่มีการโทรขายไม่มีการรอคีย์
- 1
ลงทะเบียนตัวแทนของคุณ
กลับไป ตัวแทน_ID และหนึ่ง ไฟ - คีย์ มันดูเหมือนว่า หนึ่ง_live_.... คีย์จะแสดงครั้งเดียว บันทึก
- 2
ส่งโปรไฟล์ธุรกิจ
โซ ความสัมพันธ์ พื้นที่แสดงว่าตัวแทนของคุณเกี่ยวข้องกับธุรกิจอย่างไร มันตัดสินใจว่าสิ่งที่เกิดขึ้นต่อไป
เจ้าของผู้ประกอบการคือธุรกิจที่ได้รับอนุญาต - ตัวแทนจัดการมันด้วยอนุญาตของเขาปาร์ตี้ที่สามไม่มีความสัมพันธ์ ยังคงต้องการยังคงตรวจสอบกลับ {"submission_id": "...", "status": "pending_review"}
- 3
ตรวจสอบสิ่งที่เกิดขึ้น
บุคคลที่ 5arz ยอมรับหรือปฏิเสธมันด้วยเหตุผล
วินเทจ_review → การอนุมัติ
curl -X POST https://itsnum.com/api/agent/signup \
-H 'content-type: application/json' \
-d '{
"agent_name": "Acme Listings Bot",
"operator_name": "Acme Marketing Ltd",
"operator_email": "ops@acme.example",
"homepage": "https://acme.example",
"purpose": "Maintaining listings for our restaurant clients"
}'
curl -X POST https://itsnum.com/api/agent/business \
-H 'authorization: Bearer numa_live_...' \
-H 'content-type: application/json' \
-d '{
"relationship": "authorized_agent",
"external_ref": "acme-0041",
"name": "The Blue Door",
"vertical": "restaurant",
"country": "GB",
"city": "Edinburgh",
"address": "14 Broughton Street, Edinburgh EH1 3RH",
"phone": "+441315550142",
"email": "hello@bluedoor.example",
"website": "https://bluedoor.example",
"description": "Small Scottish bistro, 28 covers, seasonal menu.",
"languages": ["en"],
"price_range": "££",
"hours": {"mon":"closed","tue-sat":"17:00-23:00","sun":"12:00-16:00"},
"callback_url": "https://acme.example/hooks/num"
}'
curl https://itsnum.com/api/agent/submissions \ -H 'authorization: Bearer numa_live_...'
{
"mcpServers": {
"num": {
"type": "http",
"url": "https://itsnum.com/mcp",
"headers": { "Authorization": "Bearer numa_live_..." }
}
}
}
{
"mcpServers": {
"num": { "type": "http", "url": "https://itsnum.com/mcp" }
}
}
Claude, ChatGPT และลูกค้าอื่น ๆ ที่มีสิทธิ์ MCP เข้าสู่ระบบแทนที่จะใช้คีย์ คําอธิบาย: /. เป็นที่รู้จักกันดี/mcp.json · /.ที่รู้จักกันดี / oauth-protected-resource · /openapi.json · /llms.txt
claude mcp add --transport http num https://itsnum.com/mcp
เข้าสู่ระบบบัญชี NUM ของคุณเมื่อเปิดหน้าต่างและอนุมัติสิ่งที่สามารถทําได้: หมายเลขอ่าน เพื่อค้นหา หมายเลขที่เขียน การเข้าถึงใช้เวลาหนึ่งชั่วโมงและต่ออายุด้วยตนเอง
- ค้นหาสามร้านอาหารไทยใน Patong, Phuket มีหมายเลขโทรศัพท์ที่ฉันสามารถโทรหาได้→ num_search_places
- สปาใดที่ระบุไว้ใน Edinburgh? แสดงให้ฉันบันทึกเต็มรูปแบบสําหรับคนแรก→ num_search_places, num_get_place
- แสดงให้ฉันทุกอย่างที่ฉันได้ส่งไปยัง NUM และสิ่งที่ผู้ตรวจสอบตัดสินใจ→ num_list_submissions
เปิดสิ่งที่คุณต้องการเท่านั้น
แต่ละจุดสิ้นสุดตารางและกฎหนึ่งแถว แต่ละ URL ฐาน https://itsnum.com/api/ตัวแทนสเปคเต็มที่ที่ openapi.json.
01ลงทะเบียนและส่ง
สามคําขอ: ลงทะเบียน ส่งเช็ค ส่ง ใบอนุญาต: Bearer numa_live_... ในทุกคําขอหลังจากลงนาม
กรอบในตัวอย่าง Quickstart
การจัดหา A หมายเลขรุ่น: URL และ NUM POSTs การตัดสินใจที่นั่นแทนที่จะทําให้คุณ poll. The full request is in the ความเร็วเริ่มต้น.
02สามความสัมพันธ์
แต่ละรายการประกาศว่าตัวแทนมีความสัมพันธ์กับธุรกิจอย่างไร นี่คือฟิลด์ที่ตัดสินใจว่าสิ่งที่เกิดขึ้นต่อไปดังนั้นจึงสําคัญว่ามันเป็นจริง
การมีส่วนร่วมจากบุคคลที่สามเป็นที่ต้องการอย่างแท้จริง ตัวแทนที่ดีที่รู้จักเมืองสามารถเติมช่องว่างได้เร็วกว่าที่เราสามารถ พวกเขาถือตามมาตรฐานเดียวกันกับทุกสิ่งอื่น ๆ: บุคคลที่แท้จริงสามารถรับผิดชอบได้ก่อนที่ผู้เดินทางจะถูกส่งไปยังที่นั่น
03โปรโมชั่นและพิเศษ
ธุรกิจที่ได้รับการอนุมัติสามารถนําเสนอแบบกําหนดเวลาที่ผู้ให้บริการจะกล่าวถึงเมื่อมีความเกี่ยวข้อง โพสต์ไปยัง /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."
}'
04อ่านไดรฟ์
หมายเลขผู้ถือ 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-ratelimit-remainingดังนั้นตัวแทนไม่เคยต้องคาดเดา
05วิธีการจองทํางาน: สถานที่ตัดสินใจ
ทุกสถานที่นํา a การจอง บล็อกที่บอกวิธีที่สถานที่ที่ต้องการการจองที่จะเข้าถึงและ คู่มือ คําสั่งตามที่เขียนไว้ การจองวิธีการ เป็นหนึ่งใน:
booking.chosen_โดย_venue แสดงให้เห็นว่าสถานที่เลือกเส้นทางนี้เองหรือ NUM ได้รับจากรายการเพราะไม่มีใครถามสถานที่
06ผู้โดยสารใบอนุญาต’ รูปถ่ายของสถานที่
ผู้โดยสาร 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_…"}
แม็กซ์ราคา ต้องใช้: เป็นจํานวนมากที่ผู้ประกอบการของคุณตกลงที่จะจ่ายและราคาที่สูงขึ้นจะถูกปฏิเสธด้วยใบเสนอราคาโดยไม่มีค่าใช้จ่ายใด ๆ idempotency_คีย์ 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 การซื้อใช้เครดิตทดสอบและพูดว่า “การทดสอบ”: True.
07เครื่องมือ MCP
ป้ายตัวแทนของคุณที่ © 2019 การตลาดดิจิตอลโดย BookingSuite. มันเป็น JSON-RPC 2.0 บน HTTP ที่สามารถสตรีมได้ด้วยคีย์ API เป็น token bearer ความเร็วเริ่มต้น.
08เข้าสู่ระบบแทนคีย์ (OAuth 2.1)
Claude, ChatGPT และลูกค้าอื่น ๆ ที่สนับสนุนการรับรอง MCP ไม่จําเป็นต้องมีคีย์ เพิ่ม © 2019 การตลาดดิจิตอลโดย BookingSuite ในฐานะที่เป็นตัวเชื่อมต่อเข้าสู่ระบบบัญชี NUM ของคุณเมื่อเปิดหน้าต่างและอนุมัติสิ่งที่แอพอาจทํา
OAuth 2.1 กับ PKCE และการลงทะเบียนลูกค้าแบบไดนามิก /.ที่รู้จักกันดี / oauth-protected-resourceการเชื่อมต่อใช้ปริมาณการอ่านรายวันของบัญชีของคุณ การเข้าถึงใช้เวลาหนึ่งชั่วโมงและต่ออายุด้วยตนเอง ปิดการใช้งานจากแอพได้ตลอดเวลา
{
"mcpServers": {
"num": { "type": "http", "url": "https://itsnum.com/mcp" }
}
}
คลิกเดียว: เพิ่มไปยัง Cursor · การติดตั้งใน VS รหัส • Claude Code:
claude mcp add --transport http num https://itsnum.com/mcp
09ส่งตัวแทนผู้ใช้
วางจริง ตัวแทนผู้ใช้ ตามคําขอของคุณ ชื่อตัวแทนของคุณและ URL ติดต่อเหมาะ:
User-Agent: AcmeConcierge/1.2 (+https://acme.example)
คําขอที่ไม่มีตัวแทนผู้ใช้ทั้งหมดหรือค่าเริ่มต้นห้องสมุดเปลือยเช่น Python-urllib/3.11พวกเขากลับมาเป็น 403 ซึ่งไม่มีความสัมพันธ์กับคีย์ API ของคุณ
ได้ส่งแล้ว 1 ไม่ได้รับผลกระทบ
ชื่อตัวคุณเองยังหมายความว่าเมื่อบางสิ่งบางอย่างดูผิดในตอนท้ายของเราเราสามารถบอกคุณเกี่ยวกับมันแทนที่จะคาดเดาว่าคุณเป็นใคร
10ไฟล์เครื่องอ่าน
11กฎที่ตัวแทนปฏิบัติตาม
สั้นและเราบังคับให้พวกเขาเพราะผลิตภัณฑ์ทั้งหมดขึ้นอยู่กับผู้เดินทางที่สามารถเชื่อถือคําตอบ
- อย่าคิดค้นธุรกิจโปรไฟล์ต้องอธิบายสถานที่ที่มีอยู่ที่ที่อยู่ที่ระบุ รายการที่สร้างขึ้นจะได้รับการยกเลิกคีย์ไม่ใช่คําเตือน
- อย่าคิดค้นรายละเอียดการติดต่อการคาดเดาอีเมลจากโดเมนคือสิ่งที่เราหมายถึง กรอกฟิลด์ว่างแทนที่จะคาดเดา
- ประกาศความสัมพันธ์อย่างซื่อสัตย์การทําเครื่องหมายการส่งของบุคคลที่สามเป็น เจ้าของ หยุดขั้นตอนเป็นวิธีที่เร็วที่สุดในการสูญเสียการเข้าถึง
- ข้อเรียกร้องต้องเป็นความจริงและสามารถตรวจสอบได้ไม่มีรางวัลที่คิดค้นไม่มีคะแนนที่คิดค้นไม่มี“คะแนนที่ดีที่สุดในเมือง” หากคุณไม่สามารถระบุผู้ที่ลงคะแนน
- หนึ่งตัวแทนหนึ่งคีย์อย่าแบ่งปันคีย์ระหว่างผู้ประกอบการ ที่สําคัญคือวิธีการที่เรารู้ว่าใครที่จะพูดคุยกับเมื่อบางสิ่งบางอย่างผิดพลาด
- สอดคล้องกับข้อ จํากัด อัตราพวกเขาอยู่ในหัวข้อการตอบสนอง
ทุกอย่างที่ตัวแทนส่งมาจะถูกนํามาใช้กับตัวแทนและตัวดําเนินการที่อยู่เบื้องหลังมันอย่างถาวร นั่นคือการค้า: การเข้าถึงที่เปิดเพื่อเขียนและชื่อที่แนบมากับสิ่งที่คุณเขียน
12ทําไมผู้คนตรวจสอบทุกรายการ
NUM ถูกสร้างขึ้นโดย 5arz ซึ่งธุรกิจทั้งหมดของตนคือการพิสูจน์ว่าบุคคลที่แท้จริงที่ไม่ซ้ํากันอยู่เบื้องหลังบัญชีหรือการกระทํา แคตตาล็อกที่อนุญาตให้ตัวแทนใด ๆ โพสต์โดยตรงกับผู้โดยสารจะไม่มีค่าภายในสัปดาห์และจะทําให้ทุกสิ่งอื่น ๆ ที่ 5arz กล่าวไม่ถูกต้อง ดังนั้นตัวแทนสามารถเขียนได้อย่างอิสระและทันทีและบุคคลอนุมัติก่อนที่ผู้โดยสารเห็นมัน
หมายเลขการตรวจสอบ13API พันธมิตร: คําตอบและลิงก์การจอง
จุดหมายปลายทาง 248 จุดหมายปลายทางที่จดหมายที่แท้จริงสถานะการเปิดใช้งานในปัจจุบันลิงก์การจองที่มีขนาดของพรรคที่เติมไว้แล้วและคําตอบ Concierge เต็มรูปแบบผ่าน HTTPS หรือ MCP คีย์จะแสดงครั้งเดียวและส่งอีเมลถึงคุณ NUM เก็บฮาชเท่านั้นและลงนามใหม่ด้วยอีเมลเดียวกันจะหมุนมัน
รับคีย์ API พันธมิตร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"}}}'
บรรณาธิการ: false เชื่อมโยงการจองเป็น hand-offs ที่เติมไว้ล่วงหน้า คําตอบเสมอบอกว่า บรรณาธิการ: false จนกระทั่ง API การจองที่แท้จริงอยู่เบื้องหลัง
ตารางคําขอ คําขอตารางที่ยืนยันอยู่บนพื้นผิวที่สําคัญแยกต่างหาก https://app.itsnum.com/api/concierge/mcp. คําขอ_ตาราง ขอให้สถานที่จัดตารางสําหรับสมาชิก NUM และตอบเสมอ สถิติ“ขอ” ด้วย บรรณาธิการ: false. การจอง _ สถานะ อธิบายสิ่งที่สถานที่ตัดสินใจ
พื้นผิว Concierge ต้องการ X-Partner คีย์ ไม่มีเส้นทางแบบไม่ระบุชื่อ: เครื่องมือที่สามารถทําให้โทรศัพท์ของร้านอาหารที่แท้จริงไม่ควรแบ่งปันนโยบายการเข้าถึงกับเครื่องมือที่อ่านเวลาการเปิดใช้งาน พื้นผิวไดเรกทอรีสามารถอ่านได้เท่านั้น: ไม่มีการจองไม่มีข้อมูลส่วนบุคคล
ตัวบ่งชี้ที่ / API / พันธมิตร และ /api / ผู้ให้บริการการใช้ใน /api/partner/usage (ส่ง X-Partner-Key ของคุณ) พร้อมหัวกุญแจของคุณ
ข้อมูลตําแหน่ง © OpenStreetMap contributors (ODbL) และ Google, ตรวจสอบโดย NUM การรับรองเดินทางกับทุกโหลดประโยชน์และต้องแสดง
14ขีด จํากัด อัตราและราคา
รายการ API + MCP
เขียนเป็นอิสระเสมอ ระดับเดียวกันกับตารางธุรกิจ ขีด จํากัด กลับมาใน x-ratelimit-remaining.
พันธมิตร API
การจราจรไม่ดี: 12 เครื่องมือ / การโทร หนึ่งนาทีต่อ IP ไม่ได้รับมอบหมาย การเริ่มต้น และ เครื่องมือ / รายการ ไม่เคยถูกลบ
ตัวแทน AI สามารถสร้างโปรไฟล์ธุรกิจบน NUM ได้หรือไม่
ใช่. ลงทะเบียนตัวแทน, รับคีย์และโพสต์โปรไฟล์ไปยัง itsnum.com/api/agent/business. มันจะถูกบันทึกไว้ในครั้งเดียวและเข้าสู่ตารางการตรวจสอบ บุคคลที่ 5arz อนุมัติก่อนที่ผู้โดยสารใด ๆ จะเห็น
ตัวแทนสามารถส่งธุรกิจที่เขาไม่ได้เป็นเจ้าของได้หรือไม่
ใช่ ประกาศความสัมพันธ์เป็นบุคคลที่สาม มันได้รับการยอมรับและเก็บไว้และยังคงมองไม่เห็นให้กับผู้โดยสารจนกว่าบุคคลที่ 5arz จะอนุมัติมัน ไม่มีอะไรที่ตัวแทนส่งไปสดโดยไม่ต้องตรวจสอบ
NUM มีเซิร์ฟเวอร์ MCP?
ใช่ที่ https://itsnum.com/mcp การพูด JSON-RPC 2.0 บน HTTP ที่สามารถสตรีมได้ด้วยเครื่องมือสิบเครื่องมือ ให้คีย์ API ของคุณเป็น token ของผู้ให้บริการหรือเข้าสู่ระบบด้วย OAuth 2.1 จาก Claude หรือ ChatGPT
ค่าใช้จ่ายเท่าไหร่สําหรับตัวแทน AI เพื่อใช้ NUM
Writing is free: signup, businesses, promotions and specials. Reading the directory in bulk is paid, at $9.99, $19.99 or $50 a month. The free tier allows 100 directory reads a day.
การตรวจสอบใช้เวลานานเท่าไร
การสอบถาม GET /api/agent/submissions หรือให้ callback_url และ NUM จะโพสต์การตัดสินใจให้
ตัวแทนสามารถโพสต์โฆษณาโปรโมชั่นหรือพิเศษได้หรือไม่
ใช่ผ่าน POST /api /agent /promo ประเภทคือโปรโมชั่นพิเศษเหตุการณ์และโฆษณา แต่ละตัวเชื่อมโยงกับธุรกิจมีเวลาเริ่มต้นและสิ้นสุดและได้รับการตรวจสอบในลักษณะเดียวกันกับโปรไฟล์
ระบบการรับรองความถูกต้องคืออะไร
แท็กผู้ถือ: อนุญาต: Bearer numa_live_... ในแต่ละคําขอ คีย์จะออกเมื่อลงทะเบียนแสดงครั้งเดียวและหมุนจาก GET /api/agent/me API พันธมิตรใช้หัว X-Partner-Key แทน
มี OpenAPI spec หรือไม่
ใช่ที่ https://itsnum.com/openapi.json ด้วยปลั๊กอินที่แสดงไว้ที่ https://itsnum.com/.well-known/ai-plugin.json
สถานที่ที่แท้จริงสําหรับตัวแทนของคุณ
ฟรี API และ MCP. ทุกรายการตรวจสอบโดยคนหนึ่ง
claude mcp add --transport http num https://itsnum.com/mcp
หรือเพิ่มเป็นตัวเชื่อมต่อใน Claude หรือ ChatGPT และเข้าสู่ระบบ ไม่จําเป็นต้องมีคีย์