დეველოპერებისთვის
სამუშაო სივრცის ინტეგრაციის API
დააკავშირეთ თქვენი კომპანიის სისტემები Krebsiti-ის სამუშაო სივრცესთან: შექმენით და მართეთ აგენტები, გაანაწილეთ კრედიტები, ატვირთეთ ფაილები ცოდნის ბაზაში და სინქრონში იქონიეთ კლიენტები, საქმეები და კალენდარი REST API-ით.
სარჩევი
მიმოხილვა
API სამუშაო სივრცეს იმავე წესებით მართავს, რითაც ვებ-აპლიკაცია: იგივე უფლებები, ბილინგი და ცვლილებების ისტორია. გასაღები მოქმედებს მისი შემქმნელის სახელით და მხოლოდ იმ უფლებებით, რომლებიც მას მისცეს. მოთხოვნა და პასუხი JSON-ია, ფაილები multipart/form-data-თი იტვირთება.
რისი გაკეთება შეგიძლიათ
- აგენტების შექმნა, რედაქტირება, შეჩერება და წაშლა, პაროლის აღდგენა
- კომპანიის ბალანსი და მოხმარება, კრედიტების განაწილება და ლიმიტები
- ცოდნის ბაზის კოლექციები და ფაილების ატვირთვა
- კლიენტები, საქმეები და საქმის ფაილები
- კალენდრის მოვლენები
- როლები და ჯგუფები
სწრაფი დაწყება
1. შექმენით გასაღები
სამუშაო სივრცეში გახსენით „კომპანია“ → „ინტეგრაცია“ და შექმენით გასაღები საჭირო უფლებებით. დააკოპირეთ: სრული გასაღები მხოლოდ ერთხელ ჩანს. შეინახეთ სერვერზე, მაგალითად გარემოს ცვლადში KREBSITI_API_KEY. შექმნისას (და მოგვიანებით „რედაქტირებით“) შეგიძლიათ დააყენოთ ვადა (1 საათიდან 2 წლამდე ან უვადო), დაშვებული IP მისამართები და დომენები, და მოთხოვნების ლიმიტი. გასაღები, რომელსაც agents:write ან credits:write უფლება აქვს, პერსონალის ანგარიშებს ქმნის და კრედიტებს გადააქვს: მოეპყარით როგორც წევრის შესვლის პაროლს.
2. შეამოწმეთ ბალანსი
პირველი მოთხოვნა: კომპანიის კრედიტების ბალანსი. გასაღებს workspace:read უფლება სჭირდება.
curl "https://krebsiti.com/api/integration/v1/balance" \ -H "Authorization: Bearer $KREBSITI_API_KEY"3. შექმენით აგენტი
გაგზავნეთ POST /agents აგენტის სახელით, გვარითა და ელ. ფოსტის პრეფიქსით (agents:write). პასუხში მოდის აგენტი და დროებითი პაროლი, მხოლოდ ერთხელ. „Create an agent“ აღწერაში