დეველოპერებს

დააკავშირეთ WŬMÙ თქვენს სისტემებთან

WŬMÙ ინტეგრაციებისთვის სამი გზით არის ღია: აპები შედიან OAuth 2.0-ით PKCE-ით და მონაცემებთან მუშაობენ REST API v2-ით, რომელსაც OpenAPI აღწერა აქვს, ხოლო AI ასისტენტები MCP სერვერს ბმულით უკავშირდებიან.

გასაღები გაიცემა დეველოპერის კაბინეტში: შედით WŬMÙ-ში, შექმენით აპი და მიიღეთ client_id.

https://wumu.ai

ავტორიზაცია
/api/oauth/authorize
ტოკენები
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
MCP სერვერი
/mcp

დაკავშირების სამი გზა

აირჩიეთ, როგორ დაუკავშირდეთ

თქვენი აპი ან სერვისი უკავშირდება OAuth-ითა და REST API-ით. AI ასისტენტი — MCP სერვერით, აპის რეგისტრაციის გარეშე.

  • OAuth 2.0 PKCE-ით

    საიტებისთვის, სერვისებისა და მობილური აპებისთვის, რომლებიც WŬMÙ-ის მომხმარებლის მონაცემებთან მისი თანხმობით მუშაობენ.

    • ავტორიზაციის კოდი PKCE-ით (S256) და განახლების ტოკენების როტაციით; სერვერიდან სერვერზე კავშირისთვის — client_credentials
    • მომხმარებელი ხედავს თანხმობის ეკრანს და გასცემს მხოლოდ საჭირო ნებართვებს: პროფილი, დოკუმენტები, ჩატები, კონტაქტები და სხვა
    • საჯარო კლიენტებს — მობილურ აპებსა და SPA-ს — საიდუმლო გასაღები არ ეძლევათ
    • HMAC-SHA256-ით ხელმოწერილი ვებჰუკები და მოთხოვნებისა და მიწოდებების ჟურნალი დეველოპერის კაბინეტში
    • ახალი აპი მუშაობას იწყებს WŬMÙ-ის ადმინისტრატორის შემოწმების შემდეგ
  • REST API v2

    JSON API დოკუმენტებისთვის, ცხრილებისთვის, AI ჩატებისთვის, მესენჯერისთვის, კონტაქტებისთვის, კალენდრისა და WŬMÙ-ის სხვა განყოფილებებისთვის.

    • მანქანურად წაკითხვადი OpenAPI აღწერა: ყოველ ოპერაციას მითითებული აქვს საჭირო ნებართვები
    • წვდომის ტოკენი გადაეცემა სათაურში Authorization: Bearer
    • მოთხოვნების ლიმიტი წუთში თითოეული წყვილისთვის „აპი — მომხმარებელი“; გადაჭარბებისას პასუხია 429
  • MCP სერვერი

    AI ასისტენტი WŬMÙ-ის ანგარიშს ბმულით უკავშირდება — გასაღებების, დეველოპერის აპისა და პროგრამების დაყენების გარეშე.

    • Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT დეველოპერის რეჟიმში, Cursor და სხვა კლიენტები, რომლებიც დისტანციურ MCP სერვერებსა და OAuth-ით შესვლას უჭერენ მხარს
    • შედიხართ საკუთარი ანგარიშით და განყოფილებებს თავად რთავთ; წაკითხვა და ცვლილება ცალკე გადამრთველებია
    • სხვა ადამიანების მონაცემების შემცველი განყოფილებები — მოთხოვნები, მესენჯერი, კონტაქტები — ნაგულისხმევად გამორთულია
    • ასისტენტის გათიშვა ნებისმიერ დროს შეგიძლიათ ანგარიშის უსაფრთხოების პარამეტრებში

    დაკავშირების მისამართი

    • https://wumu.ai/mcpwumu.ai-ზე არსებული ანგარიშისთვის
    • https://wumu.ru/mcpwumu.ru-ზე არსებული ანგარიშისთვის (რუსეთი)

მოთხოვნის მაგალითი

პირველი მოთხოვნა

მიიღეთ წვდომის ტოკენი OAuth-ით და გადაეცით სათაურში: პირველი მოთხოვნა დააბრუნებს AI იურისტთან თქვენს ბოლო ხუთ ჩატს და საჭიროებს ნებართვას read:chats. მეორე ბრძანება WŬMÙ-ის MCP სერვერს Claude Code-ში ამატებს.

# ბოლო ხუთი ჩატი AI იურისტთან
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# WŬMÙ-ის MCP სერვერის დამატება Claude Code-ში
claude mcp add --transport http wumu https://wumu.ai/mcp
ყველა ოპერაცია — OpenAPI აღწერაში

დეველოპერების კითხვები

სჭირდება თუ არა WŬMÙ-ის API-ს ფასიანი გეგმა?

OAuth აპებსა და REST API v2-ს ფასიანი გეგმა არ სჭირდება: აპის შექმნა შეიძლება WŬMÙ-ის ნებისმიერ გეგმაზე, მათ შორის უფასოზე. AI ასისტენტის WŬMÙ-ის MCP სერვერთან დაკავშირება უფასო გეგმაზეც შეიძლება — თქვენს პროფილზე, ქალაქის მონახაზებსა და დახმარების ცენტრზე წვდომით; დანარჩენი განყოფილებებისთვის საჭიროა თქვენი საკუთარი Pro ან უფრო მაღალი გეგმა, Business-ის საცდელი პერიოდიც გამოდგება.

როგორ მივიღო WŬMÙ-ის API გასაღები?

შედით WŬMÙ-ში და გახსენით დეველოპერის კაბინეტი. შექმენით აპი: სახელი, დაბრუნების მისამართები და ნებართვები. მიიღებთ client_id-ს, სერვერული აპი კი — client_secret-საც: ის მხოლოდ ერთხელ ჩანს, შეინახეთ. აპი ტოკენების გაცემას WŬMÙ-ის ადმინისტრატორის შემოწმების შემდეგ იწყებს.

სად არის WŬMÙ-ის REST API-ის აღწერა?

REST API v2-ის OpenAPI აღწერა შესვლის გარეშე ხელმისაწვდომია მისამართზე /api/v2/openapi.json: ჩატვირთეთ ის ნებისმიერ ხელსაწყოში, რომელიც OpenAPI-ს იგებს, ან მისით კლიენტი დააგენერირეთ. WŬMÙ-ის ავტორიზაციის სერვერის პარამეტრები მისამართზეა /.well-known/openid-configuration.

OpenAPI აღწერის გახსნა
ზღუდავს თუ არა WŬMÙ-ის API მოთხოვნების რაოდენობას?

დიახ. REST API v2 ზღუდავს თითოეულ წყვილს „აპი — მომხმარებელი“: ნაგულისხმევად წუთში 100 მოთხოვნა, ზოგ განყოფილებას კი, მაგალითად მესენჯერს, საკუთარი ლიმიტი აქვს. გადაჭარბებისას სერვერი 429 სტატუსით პასუხობს — გაიმეორეთ მოთხოვნა მოგვიანებით. MCP-ით დაკავშირებულ AI ასისტენტსაც აქვს წუთობრივი ლიმიტი.

რით განსხვავდება WŬMÙ-ის MCP სერვერი OAuth აპისგან?

WŬMÙ-ის MCP სერვერი AI ასისტენტებისთვის მზა კავშირია: არაფრის რეგისტრაცია არ არის საჭირო, საკმარისია მისამართის ჩასმა და საკუთარი ანგარიშით შესვლა. OAuth აპი გჭირდებათ, როცა საკუთარ ინტეგრაციას წერთ — საიტს, სერვისს ან მობილურ აპს, რომელიც მომხმარებლების სახელით REST API v2-ს მიმართავს.

დაიწყეთ ინტეგრაცია

შედით WŬMÙ-ში, შექმენით აპი დეველოპერის კაბინეტში და მიიღეთ გასაღები.