calvinturbo

apiary Schedular

Jun 21st, 2017
579
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 34.81 KB | None | 0 0
  1. # this is an example of the Uber API
  2. # as a demonstration of an API spec in YAML
  3. swagger: '2.0'
  4. info:
  5. title: Schedular API
  6. description: Use Schedular APIs to book rooms and people
  7. version: "1.0.0"
  8. # the domain of the service
  9. host: api.schedular.eu
  10. # array of all schemes that your API supports
  11. schemes:
  12. - https
  13. # will be prefixed to all paths
  14. basePath: /api/v1
  15. produces:
  16. - application/json
  17. paths:
  18. /projectinternus/companies:
  19. get:
  20. summary: Get all companies
  21. description: Get all project internus companies
  22. tags:
  23. - Project Internus
  24. responses:
  25. 200:
  26. description: Array with companies info
  27. /projectinternus/isRoomAvailable:
  28. get:
  29. summary: Is a room available?
  30. description: Is a chosen room available at a certain datetime
  31. parameters:
  32. - name: room_id
  33. in: formData
  34. description: room ID of the room you want to check
  35. type: string
  36. - name: start
  37. in: formData
  38. description: UNIX_TIMESTAMP of start datetime appointment
  39. required: true
  40. type: integer
  41. format: int64
  42. default: 1485526345
  43. - name: duration
  44. in: formData
  45. description: Duration in minutes
  46. required: true
  47. type: integer
  48. format: int64
  49. default: 60
  50. - name: people
  51. in: formData
  52. description: Amount of people
  53. required: true
  54. type: integer
  55. format: int64
  56. default: 5
  57. tags:
  58. - Project Internus
  59. responses:
  60. 200:
  61. description: JSON response of rooms with info and availability
  62. examples:
  63. application/json:
  64. room_id: 1
  65. company_id: 1
  66. name: The Kid Room
  67. people_capacity: 10
  68. image_url: https://yolodetolo.com/image.jpg
  69. description: Stupid children making noise
  70. schema:
  71. type: array
  72. items:
  73. type: array
  74. properties:
  75. room_id:
  76. type: integer
  77. format: int64
  78. name:
  79. type: string
  80. people_capacity:
  81. type: integer
  82. format: int64
  83. image_url:
  84. type: string
  85. description:
  86. type: string
  87. /projectinternus/AvailableRooms:
  88. get:
  89. summary: Get available rooms
  90. description: Get available rooms with specific parameters sent
  91. parameters:
  92. - name: start
  93. in: formData
  94. description: UNIX_TIMESTAMP of start datetime appointment
  95. required: true
  96. type: integer
  97. format: int64
  98. default: 1485526345
  99. - name: duration
  100. in: formData
  101. description: Duration in minutes
  102. required: true
  103. type: integer
  104. format: int64
  105. default: 60
  106. - name: people
  107. in: formData
  108. description: Amount of people
  109. required: true
  110. type: integer
  111. format: int64
  112. default: 5
  113. - name: chash
  114. in: header
  115. description: Hash to authorize actions with a certain company
  116. required: true
  117. type: string
  118. tags:
  119. - Project Internus
  120. responses:
  121. 200:
  122. description: JSON response of rooms with info and availability
  123. examples:
  124. application/json:
  125. room_id: 1
  126. company_id: 1
  127. name: The Kid Room
  128. people_capacity: 10
  129. image_url: https://yolodetolo.com/image.jpg
  130. description: Stupid children making noise
  131. schema:
  132. type: array
  133. items:
  134. type: array
  135. properties:
  136. room_id:
  137. type: integer
  138. format: int64
  139. name:
  140. type: string
  141. people_capacity:
  142. type: integer
  143. format: int64
  144. image_url:
  145. type: string
  146. description:
  147. type: string
  148. /projectinternus/confirmAppointment:
  149. post:
  150. summary: Confirm an Appointment
  151. description: |
  152. This function is used to save the appointment
  153. parameters:
  154. - name: auth
  155. in: header
  156. description: Auth0 JWT
  157. required: true
  158. type: integer
  159. format: int64
  160. default: AUTH0_ID_TOKEN_HERE
  161. - name: appointment_startdate
  162. in: formData
  163. description: UNIX_TIMESTAMP of start datetime appointment
  164. required: true
  165. type: integer
  166. format: int64
  167. default: 1485526345
  168. - name: duration
  169. in: formData
  170. description: Duration in minutes
  171. required: true
  172. type: integer
  173. format: int64
  174. default: 60
  175. - name: people
  176. in: formData
  177. description: Amount of people
  178. required: true
  179. type: integer
  180. format: int64
  181. default: 5
  182. - name: title
  183. in: formData
  184. description: Title of appointment
  185. required: false
  186. type: string
  187. - name: description
  188. in: formData
  189. description: Description of appointment (and/or notes)
  190. required: false
  191. type: string
  192. - name: members
  193. in: formData
  194. description: Everyone in the ´CC´ field
  195. required: true
  196. type: array
  197. items:
  198. type: string
  199. minLength: 5
  200. - name: room_id
  201. in: formData
  202. description: Room ID
  203. required: true
  204. type: integer
  205. format: int64
  206. default: 1
  207. - name: chash
  208. in: header
  209. description: Hash to authorize actions with a certain company
  210. required: true
  211. type: string
  212. tags:
  213. - Project Internus
  214. responses:
  215. 200:
  216. description: JSON response of success
  217. examples:
  218. application/json:
  219. success: true
  220. /projectinternus/RoomInfo:
  221. get:
  222. summary: Get information about a room
  223. description: Get information about one specific room, no authentication needed at this point
  224. parameters:
  225. - name: room_id
  226. in: formData
  227. description: Room ID as specified in other responses
  228. required: true
  229. type: integer
  230. format: int64
  231. default: 1
  232. tags:
  233. - Project Internus
  234. responses:
  235. 200:
  236. description: JSON response of success
  237. examples:
  238. application/json:
  239. id: 1
  240. company_id: 1
  241. name: The Kid Room
  242. people_capacity: 10
  243. image_url: https://yolodetolo.com/image.jpg
  244. description: Stupid children making noise
  245. /projectinternus/retrieveAppointments:
  246. get:
  247. summary: Get all user appointments
  248. description: A way to get all the appointments from a single user
  249. parameters:
  250. - name: auth
  251. in: header
  252. description: Auth0 JWT
  253. required: true
  254. type: integer
  255. format: int64
  256. default: AUTH0_ID_TOKEN_HERE
  257. tags:
  258. - Project Internus
  259. responses:
  260. 200:
  261. description: JSON response of success
  262. examples:
  263. application/json:
  264. id: 1
  265. company_id: 1
  266. user_id: 9223372036854775807
  267. room_id: 1
  268. book_datetime: "2017-01-18 08:10:00"
  269. start_datetime: "2017-01-18 08:10:00"
  270. end_datetime: "2017-01-18 08:20:00"
  271. title: Title of the appointment if present
  272. description: Description or notes if present
  273. /projectinternus/allRooms:
  274. get:
  275. summary: Get all rooms
  276. description: A way to retrieve all the rooms within one company
  277. parameters:
  278. - name: chash
  279. in: header
  280. description: Hash to authorize actions with a certain company
  281. required: true
  282. type: string
  283. tags:
  284. - Project Internus
  285. responses:
  286. 200:
  287. description: JSON response of success, same as RoomInfo, but for all rooms
  288. /projectinternus/cancelAppointment:
  289. delete:
  290. summary: Cancel an appointment
  291. description: Change the status from an appointment to cancelled
  292. parameters:
  293. - name: auth
  294. in: header
  295. description: Auth0 JWT
  296. required: true
  297. type: integer
  298. format: int64
  299. default: AUTH0_ID_TOKEN_HERE
  300. - name: appointment_id
  301. in: formData
  302. description: Appointment ID
  303. required: true
  304. type: integer
  305. format: int64
  306. default: 1
  307. tags:
  308. - Project Internus
  309. responses:
  310. 200:
  311. description: JSON response of success
  312. examples:
  313. application/json:
  314. success: true
  315. /projectinternus/saveContacts:
  316. get:
  317. summary: Save multiple contacts
  318. description: Function to save multiple contacts, for example to upload the address book from an user to our server
  319. parameters:
  320. - name: auth
  321. in: header
  322. description: Auth0 JWT
  323. required: true
  324. type: integer
  325. format: int64
  326. default: AUTH0_ID_TOKEN_HERE
  327. - name: contacts_name[]
  328. in: formData
  329. description: Array of contacts names
  330. required: true
  331. type: array
  332. items:
  333. type: string
  334. minLength: 3
  335. default: Calvin Uijlen
  336. - name: contacts_email[]
  337. in: formData
  338. description: Array of contacts mails
  339. required: true
  340. type: array
  341. items:
  342. type: string
  343. minLength: 5
  344. tags:
  345. - Project Internus
  346. responses:
  347. 200:
  348. description: Per contact posted, the API returns a 1 or 0, 1 means the contact was inserted, 0 means it was not inserted
  349. /businessbookingdialog/companies:
  350. get:
  351. summary: Get all companies
  352. description: Get all Schedular for Business booking popup companies
  353. tags:
  354. - Schedular for Business booking popup
  355. responses:
  356. 200:
  357. description: Array with companies info
  358. /businessbookingdialog/isRoomAvailable:
  359. get:
  360. summary: Is a room available?
  361. description: Is a chosen room available at a certain datetime
  362. parameters:
  363. - name: room_id
  364. in: formData
  365. description: room ID of the room you want to check
  366. type: string
  367. - name: start
  368. in: formData
  369. description: UNIX_TIMESTAMP of start datetime appointment
  370. required: true
  371. type: integer
  372. format: int64
  373. default: 1485526345
  374. - name: duration
  375. in: formData
  376. description: Duration in minutes
  377. required: true
  378. type: integer
  379. format: int64
  380. default: 60
  381. - name: people
  382. in: formData
  383. description: Amount of people
  384. required: true
  385. type: integer
  386. format: int64
  387. default: 5
  388. tags:
  389. - Schedular for Business booking popup
  390. responses:
  391. 200:
  392. description: JSON response of rooms with info and availability
  393. examples:
  394. application/json:
  395. room_id: 1
  396. company_id: 1
  397. name: The Kid Room
  398. people_capacity: 10
  399. image_url: https://yolodetolo.com/image.jpg
  400. description: Stupid children making noise
  401. schema:
  402. type: array
  403. items:
  404. type: array
  405. properties:
  406. room_id:
  407. type: integer
  408. format: int64
  409. name:
  410. type: string
  411. people_capacity:
  412. type: integer
  413. format: int64
  414. image_url:
  415. type: string
  416. description:
  417. type: string
  418. /businessbookingdialog/AvailableRooms:
  419. get:
  420. summary: Get available rooms
  421. description: Get available rooms with specific parameters sent
  422. parameters:
  423. - name: start
  424. in: formData
  425. description: UNIX_TIMESTAMP of start datetime appointment
  426. required: true
  427. type: integer
  428. format: int64
  429. default: 1485526345
  430. - name: duration
  431. in: formData
  432. description: Duration in minutes
  433. required: true
  434. type: integer
  435. format: int64
  436. default: 60
  437. - name: people
  438. in: formData
  439. description: Amount of people
  440. required: true
  441. type: integer
  442. format: int64
  443. default: 5
  444. - name: chash
  445. in: header
  446. description: Hash to authorize actions with a certain company
  447. required: true
  448. type: string
  449. tags:
  450. - Schedular for Business booking popup
  451. responses:
  452. 200:
  453. description: JSON response of rooms with info and availability
  454. examples:
  455. application/json:
  456. room_id: 1
  457. company_id: 1
  458. name: The Kid Room
  459. people_capacity: 10
  460. image_url: https://yolodetolo.com/image.jpg
  461. description: Stupid children making noise
  462. schema:
  463. type: array
  464. items:
  465. type: array
  466. properties:
  467. room_id:
  468. type: integer
  469. format: int64
  470. name:
  471. type: string
  472. people_capacity:
  473. type: integer
  474. format: int64
  475. image_url:
  476. type: string
  477. description:
  478. type: string
  479. pricing:
  480. type: string
  481. currency:
  482. type: string
  483. rate:
  484. type: string
  485. /businessbookingdialog/confirmAppointment:
  486. post:
  487. summary: Confirm an Appointment
  488. description: |
  489. This function is used to save the appointment
  490. parameters:
  491. - name: auth
  492. in: header
  493. description: Auth0 JWT
  494. required: true
  495. type: integer
  496. format: int64
  497. default: AUTH0_ID_TOKEN_HERE
  498. - name: appointment_startdate
  499. in: formData
  500. description: UNIX_TIMESTAMP of start datetime appointment
  501. required: true
  502. type: integer
  503. format: int64
  504. default: 1485526345
  505. - name: duration
  506. in: formData
  507. description: Duration in minutes
  508. required: true
  509. type: integer
  510. format: int64
  511. default: 60
  512. - name: people
  513. in: formData
  514. description: Amount of people
  515. required: true
  516. type: integer
  517. format: int64
  518. default: 5
  519. - name: title
  520. in: formData
  521. description: Title of appointment
  522. required: false
  523. type: string
  524. - name: description
  525. in: formData
  526. description: Description of appointment (and/or notes)
  527. required: false
  528. type: string
  529. - name: members
  530. in: formData
  531. description: Everyone in the ´CC´ field
  532. required: true
  533. type: array
  534. items:
  535. type: string
  536. minLength: 5
  537. - name: room_id
  538. in: formData
  539. description: Room ID
  540. required: true
  541. type: integer
  542. format: int64
  543. default: 1
  544. - name: chash
  545. in: header
  546. description: Hash to authorize actions with a certain company
  547. required: true
  548. type: string
  549. tags:
  550. - Schedular for Business booking popup
  551. responses:
  552. 200:
  553. description: JSON response of success
  554. examples:
  555. application/json:
  556. success: true
  557. /businessbookingdialog/RoomInfo:
  558. get:
  559. summary: Get information about a room
  560. description: Get information about one specific room, no authentication needed at this point
  561. parameters:
  562. - name: room_id
  563. in: formData
  564. description: Room ID as specified in other responses
  565. required: true
  566. type: integer
  567. format: int64
  568. default: 1
  569. tags:
  570. - Schedular for Business booking popup
  571. responses:
  572. 200:
  573. description: JSON response of success
  574. examples:
  575. application/json:
  576. id: 1
  577. company_id: 1
  578. name: The Kid Room
  579. people_capacity: 10
  580. image_url: https://yolodetolo.com/image.jpg
  581. description: Stupid children making noise
  582. /businessbookingdialog/retrieveAppointments:
  583. get:
  584. summary: Get all user appointments
  585. description: A way to get all the appointments from a single user
  586. parameters:
  587. - name: auth
  588. in: header
  589. description: Auth0 JWT
  590. required: true
  591. type: integer
  592. format: int64
  593. default: AUTH0_ID_TOKEN_HERE
  594. tags:
  595. - Schedular for Business booking popup
  596. responses:
  597. 200:
  598. description: JSON response of success
  599. examples:
  600. application/json:
  601. id: 1
  602. company_id: 1
  603. user_id: 9223372036854775807
  604. room_id: 1
  605. book_datetime: "2017-01-18 08:10:00"
  606. start_datetime: "2017-01-18 08:10:00"
  607. end_datetime: "2017-01-18 08:20:00"
  608. title: Title of the appointment if present
  609. description: Description or notes if present
  610. /businessbookingdialog/allRooms:
  611. get:
  612. summary: Get all rooms
  613. description: A way to retrieve all the rooms within one company
  614. parameters:
  615. - name: chash
  616. in: header
  617. description: Hash to authorize actions with a certain company
  618. required: true
  619. type: string
  620. tags:
  621. - Schedular for Business booking popup
  622. responses:
  623. 200:
  624. description: JSON response of success, same as RoomInfo, but for all rooms
  625. /businessbookingdialog/cancelAppointment:
  626. delete:
  627. summary: Cancel an appointment
  628. description: Change the status from an appointment to cancelled
  629. parameters:
  630. - name: auth
  631. in: header
  632. description: Auth0 JWT
  633. required: true
  634. type: integer
  635. format: int64
  636. default: AUTH0_ID_TOKEN_HERE
  637. - name: appointment_id
  638. in: formData
  639. description: Appointment ID
  640. required: true
  641. type: integer
  642. format: int64
  643. default: 1
  644. tags:
  645. - Schedular for Business booking popup
  646. responses:
  647. 200:
  648. description: JSON response of success
  649. examples:
  650. application/json:
  651. success: true
  652. /businessbookingdialog/saveContacts:
  653. get:
  654. summary: Save multiple contacts
  655. description: Function to save multiple contacts, for example to upload the address book from an user to our server
  656. parameters:
  657. - name: auth
  658. in: header
  659. description: Auth0 JWT
  660. required: true
  661. type: integer
  662. format: int64
  663. default: AUTH0_ID_TOKEN_HERE
  664. - name: contacts_name[]
  665. in: formData
  666. description: Array of contacts names
  667. required: true
  668. type: array
  669. items:
  670. type: string
  671. minLength: 3
  672. default: Calvin Uijlen
  673. - name: contacts_email[]
  674. in: formData
  675. description: Array of contacts mails
  676. required: true
  677. type: array
  678. items:
  679. type: string
  680. minLength: 5
  681. tags:
  682. - Schedular for Business booking popup
  683. responses:
  684. 200:
  685. description: Per contact posted, the API returns a 1 or 0, 1 means the contact was inserted, 0 means it was not inserted
  686. /link/roomqr/{roomcode}:
  687. get:
  688. summary: Get room info from QR string
  689. description: Get all the room information belonging to a certain string saved in a QR code
  690. parameters:
  691. - name: roomcode
  692. in: path
  693. description: Roomcode (string)
  694. required: true
  695. type: string
  696. tags:
  697. - Link
  698. responses:
  699. 200:
  700. description: Room information
  701. /backend/login:
  702. post:
  703. summary: Log in to the admin panel
  704. description: dat dus
  705. parameters:
  706. - name: username
  707. in: formData
  708. description: Emailaddress
  709. required: true
  710. type: string
  711. - name: password
  712. in: formData
  713. description: Password
  714. required: true
  715. type: string
  716. - name: company_id
  717. in: formData
  718. description: Company ID
  719. required: true
  720. type: integer
  721. format: int64
  722. tags:
  723. - Admin
  724. responses:
  725. 200:
  726. description: Admin
  727.  
  728. /backend/appointment:
  729. post:
  730. summary: Save a new appointment
  731. description: Admin panel API to save a new appointment
  732. parameters:
  733. - name: userid
  734. in: header
  735. description: UserID of admin user
  736. required: true
  737. type: integer
  738. format: int64
  739. default: userid
  740. - name: apikey
  741. in: header
  742. description: API key received by server when logging on
  743. required: true
  744. type: integer
  745. format: int64
  746. default: api key
  747. - name: start
  748. in: formData
  749. description: UNIX timestamp of start_datetime
  750. required: true
  751. type: string
  752. - name: end
  753. in: formData
  754. description: UNIX timestamp of end_datetime
  755. required: true
  756. type: string
  757. - name: room_id
  758. in: formData
  759. description: room-rooms that are going to be booked, single room_id or multiple room_id, separate with comma
  760. required: false
  761. type: string
  762. - name: duration
  763. in: formData
  764. description: duration in minutes
  765. required: true
  766. type: integer
  767. format: int64
  768. - name: title
  769. in: formData
  770. description: title of appointment
  771. required: false
  772. type: string
  773. - name: description
  774. in: formData
  775. description: description of appointment
  776. required: false
  777. type: string
  778. tags:
  779. - Admin
  780. responses:
  781. 200:
  782. description: Per contact posted, the API returns a 1 or 0, 1 means the contact was inserted, 0 means it was not inserted
  783. put:
  784. summary: Update an appointment
  785. description: Admin panel API to update an appointment
  786. parameters:
  787. - name: userid
  788. in: header
  789. description: UserID of admin user
  790. required: true
  791. type: integer
  792. format: int64
  793. default: userid
  794. - name: apikey
  795. in: header
  796. description: API key received by server when logging on
  797. required: true
  798. type: integer
  799. format: int64
  800. default: api key
  801. - name: appointment_id
  802. in: formData
  803. description: ID of appointment
  804. required: true
  805. type: integer
  806. format: int64
  807. - name: start
  808. in: formData
  809. description: UNIX timestamp of start_datetime
  810. required: true
  811. type: string
  812. - name: end
  813. in: formData
  814. description: UNIX timestamp of end_datetime
  815. required: true
  816. type: string
  817. - name: room_id
  818. in: formData
  819. description: room-rooms that are going to be booked, single room_id or multiple room_id, separate with comma
  820. required: false
  821. type: string
  822. - name: duration
  823. in: formData
  824. description: duration in minutes
  825. required: true
  826. type: integer
  827. format: int64
  828. - name: title
  829. in: formData
  830. description: title of appointment
  831. required: false
  832. type: string
  833. - name: description
  834. in: formData
  835. description: description of appointment
  836. required: false
  837. type: string
  838. tags:
  839. - Admin
  840. responses:
  841. 200:
  842. description: Per contact posted, the API returns a 1 or 0, 1 means the contact was inserted, 0 means it was not inserted
  843. delete:
  844. summary: Delete an appointment
  845. description: Admin panel API to delete an appointment
  846. parameters:
  847. - name: userid
  848. in: header
  849. description: UserID of admin user
  850. required: true
  851. type: integer
  852. format: int64
  853. default: userid
  854. - name: apikey
  855. in: header
  856. description: API key received by server when logging on
  857. required: true
  858. type: integer
  859. format: int64
  860. default: api key
  861. - name: appointment_id
  862. in: formData
  863. description: ID of appointment
  864. required: true
  865. type: integer
  866. format: int64
  867. tags:
  868. - Admin
  869. responses:
  870. 200:
  871. description: Per contact posted, the API returns a 1 or 0, 1 means the contact was inserted, 0 means it was not inserted
  872. /backend/appointment/{appointment_id}:
  873. get:
  874. summary: Get an appointment
  875. description: Admin panel API to get an appointment
  876. parameters:
  877. - name: userid
  878. in: header
  879. description: UserID of admin user
  880. required: true
  881. type: integer
  882. format: int64
  883. default: userid
  884. - name: apikey
  885. in: header
  886. description: API key received by server when logging on
  887. required: true
  888. type: integer
  889. format: int64
  890. default: api key
  891. - name: appointment_id
  892. in: path
  893. description: appointment_id
  894. required: true
  895. type: integer
  896. format: int64
  897. tags:
  898. - Admin
  899. responses:
  900. 200:
  901. description: Per contact posted, the API returns a 1 or 0, 1 means the contact was inserted, 0 means it was not inserted
  902. /backend/getappointmentscalendar:
  903. get:
  904. summary: Get an appointment
  905. description: Admin panel API to get calendar appointments
  906. parameters:
  907. - name: userid
  908. in: header
  909. description: UserID of admin user
  910. required: true
  911. type: integer
  912. format: int64
  913. default: userid
  914. - name: apikey
  915. in: header
  916. description: API key received by server when logging on
  917. required: true
  918. type: integer
  919. format: int64
  920. default: api key
  921. - name: view
  922. in: formData
  923. description: day or threeday or week or month
  924. required: true
  925. type: string
  926. - name: room_id
  927. in: formData
  928. description: Room ID
  929. required: false
  930. type: integer
  931. format: int64
  932. - name: staff_id
  933. in: formData
  934. description: Staff ID
  935. required: false
  936. type: integer
  937. format: int64
  938. tags:
  939. - Admin
  940. responses:
  941. 200:
  942. description: Get all the appointments my friend
  943. /backend/room/{room_id}:
  944. get:
  945. summary: Get a room
  946. description: Admin panel API to get a room
  947. parameters:
  948. - name: apikey
  949. in: header
  950. description: API key received by server when logging on
  951. required: true
  952. type: integer
  953. format: int64
  954. default: api key
  955. - name: room_id
  956. in: path
  957. description: room ID
  958. required: true
  959. type: integer
  960. format: int64
  961. tags:
  962. - Admin
  963. responses:
  964. 200:
  965. description: Get a certain room
  966. delete:
  967. summary: Delete a room
  968. description: Admin panel API to delete a room
  969. parameters:
  970. - name: apikey
  971. in: header
  972. description: API key received by server when logging on
  973. required: true
  974. type: integer
  975. format: int64
  976. default: api key
  977. - name: room_id
  978. in: path
  979. description: room ID
  980. required: true
  981. type: integer
  982. format: int64
  983. tags:
  984. - Admin
  985. responses:
  986. 200:
  987. description: Delete the room mate
  988. /backend/userlist:
  989. get:
  990. summary: List users
  991. description: Get all connected users to a certain company
  992. parameters:
  993. - name: apikey
  994. in: header
  995. description: API key received by server when logging on
  996. required: true
  997. type: integer
  998. format: int64
  999. default: api key
  1000. tags:
  1001. - Admin
  1002. responses:
  1003. 200:
  1004. description: Get all the appointments my friend
  1005. /backend/inviteuser/{user_email}:
  1006. get:
  1007. summary: Invite User
  1008. description: Intended for invite button in backend
  1009. parameters:
  1010. - name: apikey
  1011. in: header
  1012. description: API key received by server when logging on
  1013. required: true
  1014. type: integer
  1015. format: int64
  1016. default: api key
  1017. - name: user_email
  1018. in: path
  1019. description: Email address of the user you are trying to invite
  1020. required: true
  1021. type: integer
  1022. format: int64
  1023. tags:
  1024. - Admin
  1025. responses:
  1026. 200:
  1027. description: Success true or false
  1028. /backend/staff/{staff_id}:
  1029. get:
  1030. summary: Get information about staff
  1031. description: Get one staff account
  1032. parameters:
  1033. - name: apikey
  1034. in: header
  1035. description: API key received by server when logging on
  1036. required: true
  1037. type: integer
  1038. format: int64
  1039. default: api key
  1040. - name: staff_id
  1041. in: path
  1042. description: Staff ID
  1043. required: true
  1044. type: integer
  1045. format: int64
  1046. tags:
  1047. - Admin
  1048. responses:
  1049. 200:
  1050. description: Staff info
  1051. /backend/staff:
  1052. get:
  1053. summary: Get information about staff
  1054. description: Get multiple staff account
  1055. parameters:
  1056. - name: apikey
  1057. in: header
  1058. description: API key received by server when logging on
  1059. required: true
  1060. type: integer
  1061. format: int64
  1062. default: api key
  1063. tags:
  1064. - Admin
  1065. responses:
  1066. 200:
  1067. description: Multiple staff info
  1068. definitions:
  1069. Product:
  1070. type: object
  1071. properties:
  1072. product_id:
  1073. type: string
  1074. description: Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles.
  1075. description:
  1076. type: string
  1077. description: Description of product.
  1078. display_name:
  1079. type: string
  1080. description: Display name of product.
  1081. capacity:
  1082. type: string
  1083. description: Capacity of product. For example, 4 people.
  1084. image:
  1085. type: string
  1086. description: Image URL representing the product.
  1087. PriceEstimate:
  1088. type: object
  1089. properties:
  1090. product_id:
  1091. type: string
  1092. description: Unique identifier representing a specific product for a given latitude & longitude. For example, uberX in San Francisco will have a different product_id than uberX in Los Angeles
  1093. currency_code:
  1094. type: string
  1095. description: "[ISO 4217](http://en.wikipedia.org/wiki/ISO_4217) currency code."
  1096. display_name:
  1097. type: string
  1098. description: Display name of product.
  1099. estimate:
  1100. type: string
  1101. description: Formatted string of estimate in local currency of the start location. Estimate could be a range, a single number (flat rate) or "Metered" for TAXI.
  1102. low_estimate:
  1103. type: number
  1104. description: Lower bound of the estimated price.
  1105. high_estimate:
  1106. type: number
  1107. description: Upper bound of the estimated price.
  1108. surge_multiplier:
  1109. type: number
  1110. description: Expected surge multiplier. Surge is active if surge_multiplier is greater than 1. Price estimate already factors in the surge multiplier.
  1111. Profile:
  1112. type: object
  1113. properties:
  1114. first_name:
  1115. type: string
  1116. description: First name of the Uber user.
  1117. last_name:
  1118. type: string
  1119. description: Last name of the Uber user.
  1120. email:
  1121. type: string
  1122. description: Email address of the Uber user
  1123. picture:
  1124. type: string
  1125. description: Image URL of the Uber user.
  1126. promo_code:
  1127. type: string
  1128. description: Promo code of the Uber user.
  1129. Activity:
  1130. type: object
  1131. properties:
  1132. uuid:
  1133. type: string
  1134. description: Unique identifier for the activity
  1135. Activities:
  1136. type: object
  1137. properties:
  1138. offset:
  1139. type: integer
  1140. format: int32
  1141. description: Position in pagination.
  1142. limit:
  1143. type: integer
  1144. format: int32
  1145. description: Number of items to retrieve (100 max).
  1146. count:
  1147. type: integer
  1148. format: int32
  1149. description: Total number of items available.
  1150. history:
  1151. type: array
  1152. items:
  1153. $ref: '#/definitions/Activity'
  1154. Error:
  1155. type: object
  1156. properties:
  1157. code:
  1158. type: integer
  1159. format: int32
  1160. message:
  1161. type: string
  1162. fields:
  1163. type: string
Advertisement
Add Comment
Please, Sign In to add comment