APIی Ziqme
REST، webhook و ڕووداوی ڕاستەوخۆ — هەموو شتێک لە یەک دەروازەوە تێدەپەڕێت.
REST APIیەکان
خاڵە کۆتاییەکانی RESTی وەشانکراو بۆ تیکەت، گفتوگۆ، کڕیار، وتار و ئەرکەکان — لە پشت یەک دەروازە لە api.ziqme.com.
Webhookەکان
بەشداری بکە لە ڕووداوەکانی وەک ticket.created یان chat.started و گەیاندنی واژووکراو وەربگرە بۆ خاڵە کۆتاییەکانت.
ڕووداوە ڕاستەوخۆکان
هەبەکانی SignalR تیکەت، گفتوگۆ و نوێکردنەوەکانی داشبۆرد بە زیندوویی ڕاستەوخۆ دەگەیەننە ئەپەکانی خۆت.
ڕەسەنایەتیکردن
بە بڕوانامەی کلاینتی OAuth2 یان JWTی بەکارهێنەر ڕەسەنایەتی بکە. هەر داواکارییەک چوارچێوەی شوێنی کارەکەتی لەگەڵدایە، بۆیە هەمیشە تەنها داتای خۆت دەبینیت.
سنووری ڕێژە
سنووری ڕێژەی بەکارهێنانی دادپەروەرانە بۆ هەر شوێنی کارێک لە دەروازەکەدا جێبەجێ دەکرێت. وەڵامەکان هێدەری ستانداردیان تێدایە بۆ ئەوەی یەکخستنەکەت بتوانێت بە نەرمی خۆی ڕێک بخات.
وەشانکردن
APIیەکان لە URLدا وەشان دەکرێن (ئێستا v1). گۆڕانکارییە شکێنەرەکان وەک وەشانێکی نوێ بڵاو دەکرێنەوە — یەکخستنە هەبووەکان بەردەوام دەبن لە کارکردن.
curl https://api.ziqme.com/api/v1/tickets \
-H "Authorization: Bearer $ZIQME_ACCESS_TOKEN"
HTTP/1.1 200 OK
{
"items": [
{
"id": "7d9f1c2e-4b6a-4f3d-9c1e-2a8b5d0e7f41",
"subject": "Order #1042 arrived damaged",
"status": "open",
"priority": "high"
}
],
"totalCount": 128
}