{"info":{"_postman_id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","name":"keilot.card","description":"

הוראות ל API של קהילות קארד

דבר ראשון יש להוציא API_KEY
לאתר הטסטים מהקישור https://test.kehilotcard.co.il/createApikey
לאתר הרגיל מהקישור https://m.kehilotcard.co.il/createApiKey

לקבלת גישה לאתר יש להירשם לאתר ולחכות לקבלת גישה מהמנהל

את ה API_KEY יש לשלוח בתור HADER כמו בהוראות

את כל הבקשות אפשר לשלוח גם בתור json (raw) וגם בתור urlencoded
הדגמאות מובאות ב urlencoded לצורך הנוחות בלבד

האתר לשליחת הבקשות
לאתר הרגיל https://apiforserver.kehilotcard.co.il

לטסטים https://apiforserver.kehilotcard.co.il:8443

ה store_id זה המזהה של החנות שמבצעים את הקניות בשמה בטסטים זה יהיה 1 ברגיל זה יהיה המספר של החנות שסולקים עבורה

מספר כרטיס לדוגמא בטסטים יהיה 1234567890

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21665606","collectionId":"d81c8e09-1926-40cf-9dc6-919f146a2e15","publishedId":"2sA3kUH2cJ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-07-20T23:38:16.000Z"},"item":[{"name":"קבלת פרטי כרטיס בחנויות","id":"10c32ce2-ab2c-48aa-8380-28276c96edb7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"card_code","value":"{{card_code}}","description":"

קוד הכרטיס (אפשר גם רק 7 ספרות אחרונות)

\n","type":"text"}]},"url":"{{base_url}}/store/{{store_id}}/getCardDatils","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","name":"keilot.card","type":"collection"}},"urlObject":{"path":["store","{{store_id}}","getCardDatils"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"825d73a9-b938-4413-b116-8170ba9cd954","name":"קבלת פרטי כרטיס בחנויות","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"card_code","value":"{{card_code}}","description":"קוד הכרטיס (אפשר גם רק 7 ספרות אחרונות)","type":"text"}]},"url":"{{base_url}}/store/{{store_id}}/getCardDatils"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"400"},{"key":"X-RateLimit-Remaining","value":"398"},{"key":"Date","value":"Sat, 20 Jul 2024 22:24:25 GMT"},{"key":"X-RateLimit-Reset","value":"1721514313"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"732"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 1,\n \"club_id\": 1,\n \"שם\": \"יהודה אשכול\",\n \"phone\": \"0527102554\",\n \"פעיל\": 1,\n \"מועדון\": \"חברון\",\n \"הסכם\": \"עועון\",\n \"vouchers\": [],\n \"sum_on_card\": [\n {\n \"id\": 2901,\n \"sum\": \"50.00\",\n \"בתוקף עד\": \"25/07/24\",\n \"הערות\": \"רק לקניית חליפות\",\n \"store_count\": 0\n },\n {\n \"id\": 2899,\n \"sum\": \"1087.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n },\n {\n \"id\": 2894,\n \"sum\": \"100.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 8\n },\n {\n \"id\": 2228,\n \"sum\": \"58.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n },\n {\n \"id\": 2231,\n \"sum\": \"100.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n },\n {\n \"id\": 2905,\n \"sum\": \"100.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n }\n ],\n \"groups_store_arguments\": []\n}"}],"_postman_id":"10c32ce2-ab2c-48aa-8380-28276c96edb7"},{"name":"הטענת כסף","id":"2aac0ee1-cf54-40c2-abba-455c85a0ab33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n //\"all_stores\" :true, // לשלוןח במקרה שרוצים שהטעינה תהיה לכל החנויות\r\n \"stores\": [{{store_id}}], // רשימה של מזההי חנויות לשלוח רק במקרה ששולחים all_stores False (או לא שולחים)\r\n \"categorys\": [], // רשימה של מזההי קטגוריוןת לשלוח רק במקרה ששולחים all_stores False (או לא שולחים)\r\n \"cards\": [1], // רשימה של מזההי כרטיסים\r\n \"load_type\": \"טעינה מהארנק\", //סוג הטעינה \"טעינה מהארנק\" או \"התחייבות\" חובה לשים משהו\r\n \"amount\": 123, // סכום הטעינה\r\n \"validity\": \"2030/1/20\", // תוקף הטעינה (אפשר להשאיר ריק) התאריך אמור להיות בפורמט ש mysql מכיר\r\n \"notes_to_card_holder\": \"ליל שישי\", // הערות שמחזיק הכרטיב יראה אפשר להשאיר ריק\r\n \"load_reason\" : \"תמיכה\" //סיבת הטעינה \"תמיכה\" או \"שולם ע\"י הבחור\" חובה לשים משהו\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/club/{{club_id}}/add-raw/add/cards_load","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","name":"keilot.card","type":"collection"}},"urlObject":{"path":["club","{{club_id}}","add-raw","add","cards_load"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"af87e29e-926e-4ed5-8777-75fed688a04c","name":"קבלת פרטי כרטיס בחנויות","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"card_code","value":"{{card_code}}","description":"קוד הכרטיס (אפשר גם רק 7 ספרות אחרונות)","type":"text"}]},"url":"{{base_url}}/store/{{store_id}}/getCardDatils"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"400"},{"key":"X-RateLimit-Remaining","value":"398"},{"key":"Date","value":"Sat, 20 Jul 2024 22:24:25 GMT"},{"key":"X-RateLimit-Reset","value":"1721514313"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"732"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": 1,\n \"club_id\": 1,\n \"שם\": \"יהודה אשכול\",\n \"phone\": \"0527102554\",\n \"פעיל\": 1,\n \"מועדון\": \"חברון\",\n \"הסכם\": \"עועון\",\n \"vouchers\": [],\n \"sum_on_card\": [\n {\n \"id\": 2901,\n \"sum\": \"50.00\",\n \"בתוקף עד\": \"25/07/24\",\n \"הערות\": \"רק לקניית חליפות\",\n \"store_count\": 0\n },\n {\n \"id\": 2899,\n \"sum\": \"1087.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n },\n {\n \"id\": 2894,\n \"sum\": \"100.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 8\n },\n {\n \"id\": 2228,\n \"sum\": \"58.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n },\n {\n \"id\": 2231,\n \"sum\": \"100.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n },\n {\n \"id\": 2905,\n \"sum\": \"100.00\",\n \"בתוקף עד\": null,\n \"הערות\": null,\n \"store_count\": 0\n }\n ],\n \"groups_store_arguments\": []\n}"}],"_postman_id":"2aac0ee1-cf54-40c2-abba-455c85a0ab33"},{"name":"קנייה על ידי כסף","id":"32fe1ec0-6c21-4dc4-b253-10f31ba9291c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"card_code","value":"{{card_code}}","description":"

קוד הכרטיס (אפשר גם רק 7 ספרות אחרונות)

\n","type":"text"},{"key":"sum","value":"1000","description":"

סכום כל הקנייה

\n","type":"text"},{"key":"sumFromCard","value":"20","description":"

אופצינלי \nסכום הכסף שיירד מהטענות שבכרטיס

\n","type":"text"},{"key":"chergsID","value":"[2228]","description":"

אופצינלי \nרשימה של מזהים שממנה ישתמשו לכסף שמשולם מהכרטיס

\n","type":"text","disabled":true}]},"url":"{{base_url}}/store/{{store_id}}/doUsege/money","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","name":"keilot.card","type":"collection"}},"urlObject":{"path":["store","{{store_id}}","doUsege","money"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"64ad7f11-561f-4dd3-8ee5-b92fd47c25d5","name":"קנייה על ידי כסף","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"card_code","value":"{{card_code}}","description":"קוד הכרטיס (אפשר גם רק 7 ספרות אחרונות)","type":"text"},{"key":"sum","value":"1000","description":"סכום כל הקנייה","type":"text"},{"key":"sumFromCard","value":"20","description":"אופצינלי \nסכום הכסף שיירד מהטענות שבכרטיס","type":"text"},{"key":"chergsID","value":"[2228]","description":"אופצינלי \nרשימה של מזהים שממנה ישתמשו לכסף שמשולם מהכרטיס","type":"text","disabled":true}]},"url":"{{base_url}}/store/{{store_id}}/doUsege/money"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"400"},{"key":"X-RateLimit-Remaining","value":"399"},{"key":"Date","value":"Sat, 20 Jul 2024 22:24:12 GMT"},{"key":"X-RateLimit-Reset","value":"1721514313"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"20"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\"\n}"}],"_postman_id":"32fe1ec0-6c21-4dc4-b253-10f31ba9291c"},{"name":"קנייה על ידי שוברים","id":"8615b284-6282-4690-99c1-74ebdc8cd298","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"card_code","value":"{{card_code}}","description":"

קוד הכרטיס (אפשר גם רק 7 ספרות אחרונות)

\n","type":"text"},{"key":"vouchersID","value":"[28, 29]","description":"

מזהים של השוברים שהשתמשו בהם לקנייה

\n","type":"text"}]},"url":"{{base_url}}/store/{{store_id}}/doUsege/voucher","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","name":"keilot.card","type":"collection"}},"urlObject":{"path":["store","{{store_id}}","doUsege","voucher"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"89f9d13b-ffa7-4481-afc6-6c2ff3fb8ffb","name":"קנייה על ידי שוברים","originalRequest":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"card_code","value":"{{card_code}}","type":"text"},{"key":"vouchersID","value":"[28, 29]","type":"text"}]},"url":"{{base_url}}/store/{{store_id}}/doUsege/voucher"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"400"},{"key":"X-RateLimit-Remaining","value":"399"},{"key":"Date","value":"Sat, 20 Jul 2024 23:23:49 GMT"},{"key":"X-RateLimit-Reset","value":"1721517890"},{"key":"Access-Control-Allow-Origin","value":"http://localhost:3000"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"20"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\"\n}"}],"_postman_id":"8615b284-6282-4690-99c1-74ebdc8cd298"},{"name":"קבלת כל הכרטיסים","id":"614aa646-4424-4db7-bbb8-b3e23c36e5eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"filter\": {}\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/{{role}}/get-table-info/cards/rows","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","id":"d81c8e09-1926-40cf-9dc6-919f146a2e15","name":"keilot.card","type":"collection"}},"urlObject":{"path":["{{role}}","get-table-info","cards","rows"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"614aa646-4424-4db7-bbb8-b3e23c36e5eb"}],"auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"}},"event":[{"listen":"prerequest","script":{"id":"2633c697-3c7b-46f5-9873-a7341558e3f3","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"152d1d85-7f71-4be2-8d96-2745822722ef","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"base_url","value":"http://localhost","disabled":true}]}