Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
d24:develop:v2:backend:user [2021/10/19 09:27] pavlovaa [Детализация профиля] |
d24:develop:v2:backend:user [2024/04/01 06:39] (текущий) fedorovlv [Перевод аварийной заявки на участок] |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Описание API мобильного приложения Д24 v2 ====== | ====== Описание API мобильного приложения Д24 v2 ====== | ||
+ | * **Рефакторинг апи** https://ds24.ru/wiki/doku.php?id=d24:develop:v2:backend:v2 | ||
* url продакшен сервера https://ds24.ru/piedpiper | * url продакшен сервера https://ds24.ru/piedpiper | ||
- | * url тестового сервера http://192.168.37.50:9009 | + | * url тестового сервера https://s0.ds24.ru/piedpiper |
+ | |||
+ | ====== Данное API потеряет поддержку с 04.2022 ====== | ||
+ | * **Новое апи** https://ds24.ru/wiki/doku.php?id=d24:develop:v2:backend:v2 | ||
===== Описание URL ===== | ===== Описание URL ===== | ||
Строка 70: | Строка 74: | ||
Регистрация http://server.ru/registration | Регистрация http://server.ru/registration | ||
- | Пользователь вводит свой логин и пароль на форме например "login : predeinay : superpass" , (login означает что авторизация происходит по логину и паролю) интерфейс должен закодировать эту строку в base64 чтобы получилась вот такая "строка cHJlZGVpbmF5IDogc3VwZXJwYXNz" затем интерфейс посылает http запрос с заголовком "authorization: cHJlZGVpbmF5IDogc3VwZXJwYXNz" и JSON объектом методом POST на URL: http://server.ru/registration | + | Пользователь вводит свой логин и пароль на форме например "login : predeinay : superpass" , (login означает что авторизация происходит по логину и паролю) интерфейс должен закодировать эту строку в base64 чтобы получилась вот такая "строка bG9naW4gOiBwcmVkZWluYXkgOiBzdXBlcnBhc3M=" затем интерфейс посылает http запрос с заголовком "authorization: bG9naW4gOiBwcmVkZWluYXkgOiBzdXBlcnBhc3M=" и JSON объектом методом POST на URL: http://server.ru/registration |
<code javascript> | <code javascript> | ||
// Запрос | // Запрос | ||
Строка 431: | Строка 435: | ||
"status": "Зарегистрирована", | "status": "Зарегистрирована", | ||
"status_id": 1, | "status_id": 1, | ||
- | "reasons" : 0 // кол-во доступных причин статуса (например если статус = "Отложена", то причин будет к пример 5) | + | "reasons" : 0, // кол-во доступных причин статуса (например если статус = "Отложена", то причин будет к пример 5) |
- | }, { // сделано это для удобства обработки на фронте (не делать лишний запрос если причин по статусу = 0) | + | // сделано это для удобства обработки на фронте (не делать лишний запрос если причин по статусу = 0) |
+ | "need_comment": 0 // необходимо ли обязательно указывать коммент в момент перевода заявки в данный стутус (0 нет 1 да) | ||
+ | |||
+ | }, { | ||
"status": "Требуется отклик", | "status": "Требуется отклик", | ||
"status_id": 65, | "status_id": 65, | ||
- | "reasons" : 2 | + | "reasons" : 2, |
+ | "need_comment": 1 | ||
}] | }] | ||
} | } | ||
Строка 774: | Строка 782: | ||
"price": 1000, // стоимость заявки | "price": 1000, // стоимость заявки | ||
"paid": 200 // сколько оплачено в данный момент по заявке | "paid": 200 // сколько оплачено в данный момент по заявке | ||
+ | | ||
} | } | ||
} | } | ||
Строка 951: | Строка 960: | ||
"image_name" : "some test", // Название изображения | "image_name" : "some test", // Название изображения | ||
"appointed_at": "next_week", // Дата, когда придёт исполнитель, принимает "today" / "tomorrow" / "next_week" / дату в формате "ДД.ММ.ГГГГ" | "appointed_at": "next_week", // Дата, когда придёт исполнитель, принимает "today" / "tomorrow" / "next_week" / дату в формате "ДД.ММ.ГГГГ" | ||
- | "local_at" : "12.12.2020 12:12" // Дата, когда исполнитель локализовал аварию по заявке "ДД.ММ.ГГГГ ЧЧ:МИ" | + | "local_at" : "12.12.2020 12:12", // Дата, когда исполнитель локализовал аварию по заявке "ДД.ММ.ГГГГ ЧЧ:МИ" |
+ | "material_price" : 333 // Стоимость материалов по заявке | ||
} | } | ||
} | } | ||
Строка 1747: | Строка 1757: | ||
"created_at": "06.01.2017 14:45", | "created_at": "06.01.2017 14:45", | ||
"price": 5553.99, | "price": 5553.99, | ||
+ | "material_price": 1, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": 2, | "deadline_str": 2, | ||
Строка 1761: | Строка 1772: | ||
"created_at": "19.10.2016 11:06", | "created_at": "19.10.2016 11:06", | ||
"price": null, | "price": null, | ||
+ | "material_price": 2, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1775: | Строка 1787: | ||
"created_at": "04.10.2016 18:24", | "created_at": "04.10.2016 18:24", | ||
"price": null, | "price": null, | ||
+ | "material_price": 3, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": 22, | "deadline_str": 22, | ||
Строка 1788: | Строка 1801: | ||
"created_at": "22.08.2016 14:32", | "created_at": "22.08.2016 14:32", | ||
"price": null, | "price": null, | ||
+ | "material_price": 4, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -22, | "deadline_str": -22, | ||
Строка 1802: | Строка 1816: | ||
"created_at": "11.11.2015 10:58", | "created_at": "11.11.2015 10:58", | ||
"price": null, | "price": null, | ||
+ | "material_price": 5, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1816: | Строка 1831: | ||
"created_at": "12.08.2015 11:31", | "created_at": "12.08.2015 11:31", | ||
"price": null, | "price": null, | ||
+ | "material_price": 6, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1830: | Строка 1846: | ||
"created_at": "10.03.2015 15:48", | "created_at": "10.03.2015 15:48", | ||
"price": null, | "price": null, | ||
+ | "material_price": 7, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1844: | Строка 1861: | ||
"created_at": "13.02.2015 11:16", | "created_at": "13.02.2015 11:16", | ||
"price": null, | "price": null, | ||
+ | "material_price": 8, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1858: | Строка 1876: | ||
"created_at": "15.01.2015 08:14", | "created_at": "15.01.2015 08:14", | ||
"price": null, | "price": null, | ||
+ | "material_price": 9, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1872: | Строка 1891: | ||
"created_at": "15.07.2014 14:11", | "created_at": "15.07.2014 14:11", | ||
"price": null, | "price": null, | ||
+ | "material_price": 10, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1886: | Строка 1906: | ||
"created_at": "27.05.2014 11:54", | "created_at": "27.05.2014 11:54", | ||
"price": 500, | "price": 500, | ||
+ | "material_price": 666, | ||
"appointed_str": null, | "appointed_str": null, | ||
"deadline_str": -2, | "deadline_str": -2, | ||
Строка 1937: | Строка 1958: | ||
"is_paid": "Д", // флаг оплачено | "is_paid": "Д", // флаг оплачено | ||
"price": 1000, // стоимость заявки | "price": 1000, // стоимость заявки | ||
- | "paid": 200 // сколько оплачено в данный момент по заявке | + | "paid": 200, // сколько оплачено в данный момент по заявке |
+ | "material_price" : 666, // стоимость материалов по заявке | ||
"appointed_str": null, // желаемое время прихода специалиста | "appointed_str": null, // желаемое время прихода специалиста | ||
"is_local_need": "Н", // нужна ли локализация аварии | "is_local_need": "Н", // нужна ли локализация аварии | ||
Строка 1999: | Строка 2021: | ||
==== Перевод аварийной заявки на участок ==== | ==== Перевод аварийной заявки на участок ==== | ||
<code javascript> | <code javascript> | ||
- | GET server/v2/request/:request_id/tocurrentrepair | + | POST server/v2/request/:request_id/tocurrentrepair |
JSON ответ в случае успеха: | JSON ответ в случае успеха: | ||
Строка 2140: | Строка 2162: | ||
"emp_id": 22055, | "emp_id": 22055, | ||
"not_read_push_count": 10, | "not_read_push_count": 10, | ||
- | "can_comment_to_ext_system": true, | + | "can_comment_to_ext_system": 1, // варианты 0/1 |
- | "token_id": 12345 | + | "token_id": 12345, |
+ | "can_access_material_price": true, | ||
+ | "access_status_list" : "1:2:3:4:5" //доступные для использования пользователем статусы заявок | ||
} | } | ||
</code> | </code> | ||
Строка 2179: | Строка 2203: | ||
] | ] | ||
</code> | </code> | ||
+ | |||
+ | |||
+ | ==== Измнение данных о профиле ==== | ||
+ | <code javascript> | ||
+ | POST server/v2/profile/update | ||
+ | { | ||
+ | "fcm_token": "NEWTOKEN123", // Если вдруг пуш секрет изменился на девайсе или был получен позже | ||
+ | "push_config": "З_Ф:З_Н:З_К", // какие пуши юзеру необходимы | ||
+ | "start_app" : "im started!!" // выполняется каждый раз 1 раз при запуске АПП чтобы вести статистику использования апп | ||
+ | } | ||
+ | |||
+ | Json в случае успеха | ||
+ | |||
+ | { | ||
+ | "affected_rows": 3 | ||
+ | } | ||
+ | |||
+ | </code> | ||
+ | |||
+ |