# Somany Mittr Admin API Base URL: ```https://somany-mittr-backend.herokuapp.com``` ## Log In ### Get OTP **[POST]:** ```/users/get_otp``` **Body:** ```json= { "user_mobile_number":"9811874801" } ``` **Response:** ```json= { "otp": "1572" } ``` ### Log In **[POST]:** ```/tokens.json``` **Body:** ```json= { "user_mobile_number":"9811874801", "otp":"1572" } ``` **Response:** ```json= { "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOjJ9.TffSzrDTqFVA-yXUoqiN5SPU65ljZ45HhCPbMjp4ogg", "user": { "user_first_name": "Shrivatsa", "user_last_name": "Somany", "user_type": 0 } } ``` **Note:** user_type 0 = ASM, 2 = State Head ## Signups ### Get Signups **[GET]:** ```/signups.json``` **Headers:** ```Authorization: Bearer <token>``` **Response:** ```json= [ { "id": 3, "id_number": "123467AVC", "id_image_front": "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/Capture.PNG", "id_image_back": "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/Capture_Back.PNG", "mobile_number": "9818346665" } ] ``` ### Approve Signup **[POST]:** ```/signups/approve_signup.json``` **Headers:** ```Authorization: Bearer <token>``` **Body:** ```json= { "id":<signup_id>, "first_name":"Shrivatsa", "last_name":"Somany", "dob":"yyyy-mm-dd", "mobile_number":"9811874801", "id_number":"1234567AVC", "id_image_front":<some_image_url.xyz>, "zone_id":<zone_id> } ``` **Response:** 200 OK:```{"success":"successfully signed up"}``` 422 Unprocessible Entity: ```{"error":"error approving signup", "error_details":"<some_details>"}``` 404 Not Found: ```{"error":"please check the signup id"}``` ### Reject Signup **[POST]:** ```/signups/reject_signup.json``` **Headers:** ```Authorization: Bearer <token>``` **Body:** ```json= { "id":<signup_id> } ``` **Response:** 200 OK: ```{"status":"rejection successful"}``` 404 Not Found: ```{"error":"please check the signup id"}``` ## Transaction Verifications ### Get all unverified transactions **[GET]:** ```/transactions/unverified_transactions.json``` **Headers:** ```Authorization: Bearer <token>``` **Response:** ```json= [ { "id": 1, "transaction_points": 1000, "transaction_status": 1, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-09T12:41:35.275Z" }, { "id": 2, "transaction_points": 1000, "transaction_status": 1, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-10T17:14:33.049Z" }, { "id": 3, "transaction_points": 1000, "transaction_status": 1, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-10T17:14:40.212Z" } ] ``` ### Get all verified transactions **[GET]:** ```/transactions/verified_transactions.json``` **Headers:** ```Authorization: Bearer <token>``` **Response:** ```json= [ { "id": 1, "transaction_points": 1000, "transaction_status": 2, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-09T12:41:35.275Z" }, { "id": 2, "transaction_points": 1000, "transaction_status": 2, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-10T17:14:33.049Z" }, { "id": 3, "transaction_points": 1000, "transaction_status": 2, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-10T17:14:40.212Z" } ] ``` ### Get all rejected transactions **[GET]:** ```/transactions/rejected_transactions.json``` **Headers:** ```Authorization: Bearer <token>``` **Response:** ```json= [ { "id": 1, "transaction_points": 1000, "transaction_status": 3, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-09T12:41:35.275Z", "rejection_reason": "Ate too much gobi" }, { "id": 2, "transaction_points": 1000, "transaction_status": 3, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-10T17:14:33.049Z", "rejection_reason": "Ate too much aloo" }, { "id": 3, "transaction_points": 1000, "transaction_status": 3, "user_id": 4, "user_name": "Shrivatsa Somany", "product_id": 4, "product_name": "Thistle Single Lever Faucet", "dealer_id": 1, "dealer_name": "J.B. Gupta & Sons Pvt. Ltd.", "dealer_pin_code": "110003", "bill_copies": [ "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987", "https://somanymittrapp131119-dev.s3.ap-south-1.amazonaws.com/public/sign_ups/1630172721987" ], "transaction_date": "2021-09-10T17:14:40.212Z", "rejection_reason": "Ate too much mooli, mouth stinks." } ] ``` ### Verify Transaction **[POST]:** ```/transactions/verify_transaction.json``` **Headers:** ```Authorization: Bearer <token>``` **Body:** ```json= { "id": <transaction_id>, } ``` **Response:** 200 OK: ```"status":"successfully verified", "user_verified_balance":500``` 404 Not Found: ```{"error":"transaction not found"}``` 401 Unauthorized ### Reject Transaction **[POST]:** ```/transactions/reject_transaction.json``` **Headers:** ```Authorization: Bearer <token>``` **Body:** ```json= { "id": <transaction_id>, "rejection_reason":"Ate too much gobi" } ``` **Response:** 200 OK: ```"status":"successfully rejected", "user_verified_balance":500``` 404 Not Found: ```{"error":"transaction not found"}``` 401 Unauthorized ### Zones **[GET]:** ```/zones.json``` **Headers:** ```Authorization: Bearer <token>``` **Response:** ```json= [ { "id": 4, "zone_name": "South II", "zone_abbreviation": "STH2", "zone_state_head_name": "Arun Kumar" }, { "id": 5, "zone_name": "South", "zone_abbreviation": "STH", "zone_state_head_name": null }, { "id": 6, "zone_name": "EAST", "zone_abbreviation": "EST", "zone_state_head_name": null }, { "id": 7, "zone_name": "NORTH", "zone_abbreviation": "NTH", "zone_state_head_name": null } ] ```