This collections contains all the API methods for BioConnect!
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21790252","collectionId":"9a0cd0ae-e7f7-4904-a490-b0d3141704ca","publishedId":"2sAYQfCTyZ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-01-23T18:21:42.000Z"},"item":[{"name":"Neo4j","item":[{"name":"Drug Graph","item":[{"name":"Drug Node by id","id":"f3be29e4-6bcf-4f71-930b-737a7eff3fbb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8080/api/drugGraph/DB00945","description":"This endpoint retrieves the details of a specific drug identified by its unique ID.
\nURL: /drugGraph/{id}
Description: Fetches the details of a drug specified by the ID parameter in the request.
\nThis endpoint retrieves search drugs targeting proteins similar to a specified protein
\nDetails:
\nURL: /drugGraph/targetSimilarProtein/{id}
Description: Fetches data on proteins that are similar to the one identified by the specified ID parameter. This helps in finding potential drug targets related to the given protein.
\nThis endpoint retrieves information about drugs with opposite effects on proteins, based on the specified drug ID.
\nURL: /drugGraph/oppositeEffectsOnProtein/{id}
Description: Fetches data on drugs that have opposite effects on proteins associated with the drug identified by the specified ID parameter. This endpoint returns a list of drugs and their corresponding proteins with opposite effects.
\nThis endpoint retrieves details of a specific protein, identified by its unique ID.
\nURL: /proteinGraph/{id}
Description: Fetches information about the protein specified by the ID parameter. The response includes the protein's interactions, similar proteins, drugs that enhance or inhibit the protein, and diseases the protein is involved in.
\nThis endpoint retrieves details of a specific disease, identified by its unique ID.
\nURL: /diseaseGraph/{id}
Description: Fetches information about the disease specified by the ID parameter. The response includes the disease's name and the proteins involved in the disease.
\nThis endpoint adds a new disease node to the graph database.
\nOnly admin can perform this operation.
\nURL: /diseaseGraph/add
Description: Adds a new disease to the graph database by providing its details in the request body.
\nThis endpoint updates the details of an existing disease node in the graph database.
\nOnly admin can perform this operation.
\nURL: /diseaseGraph/update
Description: Updates an existing disease node by providing its ID and the new details in the request body.
\nThis endpoint deletes a specific disease node from the graph database, identified by its unique ID.
\nOnly admin can perform this operation.
\nURL: /diseaseGraph/delete/{id}
Description: Removes the disease node specified by the ID parameter from the database.
\nThis endpoint retrieves all diseases linked to a specific drug, identified by the drug's unique ID.
\nURL: /diseaseGraph/diseaseByDrug/{id}
Description: Fetches a list of diseases associated with the drug specified by the ID parameter.
\nThis endpoint retrieves the shortest path between two diseases in the graph, identified by their unique IDs.
\nURL: /diseaseGraph/shortestPath/{id1}/{id2}
Description: Computes and returns the shortest path between two diseases, as specified by the ID parameters.
\nThis folder contains all the endpoints related exclusively to the Neo4j database
\n","event":[{"listen":"prerequest","script":{"id":"4fadf599-5f26-4327-9d3e-d78da777eeab","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"dd0fb856-40f7-4859-b0b0-125a05df4cf7","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"13fe58cb-7d07-459f-9950-50aaece2db54","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint retrieves the details of a specific protein document from the MongoDB collection, identified by its unique ID.
\nURL: /proteinDoc/{id}
Description: Fetches detailed information about a protein specified by the ID parameter. The response includes the protein's name and attributes.
\nThis endpoint performs a trend analysis of publications related to a specific protein pathway.
\nURL: /proteinDoc/trend-analysis/{pathway}
Description: Retrieves publication trends for a given pathway related to proteins. The response includes data on publication frequency over time.
\n| Pathway Name | \r","Count | \r","
|---|---|
| {{pathwayName}} | \r","{{count}} | \r","
This endpoint retrieves the pathway recurrence data for a specific subsequence of a protein.
\nURL: /proteinDoc/pathway-recurrence/{subsequence}
Description: Searches for pathway recurrence information related to a given subsequence of a protein. The response includes details on the pathways in which the subsequence is involved.
\nThis endpoint retrieves proteins associated with a specific pathway and subcellular location.
\nURL: /proteinDoc/getProteinsByPathwayAndLocation
Description: Fetches proteins that are linked to a specific pathway and subcellular location. The response includes details about each protein, such as its ID, name, and other relevant attributes.
\nThe Protein collection within MongoDB stores detailed information about proteins, including their identifiers, names and other relevant informations.
This endpoint retrieves a list of expired patents by a specific drug category.
\nURL: /drugDoc/expired-patents/{category}
Description: Fetches information on expired patents related to drugs in a specified category. The response includes the drug IDs and names associated with expired patents in that category.
\nThis endpoint retrieves details of a specific drug identified by its unique ID or name.
\nURL: /drugDoc/{id_or_name}
Description: Fetches information about a drug specified by its unique ID or name. The response includes details such as the drug's ID, name, and other relevant attributes.
\nThis endpoint retrieves publication analysis trends for a specific drug category.
\nURL: /drugDoc/trend-analysis/{category}
Description: Fetches publication analysis data, such as trends and frequency of publications, for drugs in a specific category. The response includes analysis related to publications over time for the specified drug category.
\nThe Drugcollection within MongoDB stores detailed information about drugs, including their identifiers, names and other relevant informations.
This folder contains all endpoints that interact with the MongoDB database, specifically designed to manage and query data related to proteins, drugs, and their interactions.
\n","_postman_id":"e0b6acfa-c928-4494-93d8-3211fb1f4ed6","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint adds a new protein entry to both MongoDB and Neo4j. Only users with admin privileges can add proteins.
\nThe request body should contain the following JSON object with the details of the protein to be added.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint updates an existing protein entry in both MongoDB and Neo4j. Only users with admin privileges can update protein data.
\nThe request body should contain the following JSON object with the details of the protein to be updated.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint deletes a protein entry from both MongoDB and Neo4j. Only users with admin privileges can delete protein data.
\nThis endpoint adds a new drug entry to both MongoDB and Neo4j. Only users with admin privileges can add drug data.
\nThe request body should contain the following JSON object with the details of the drug to be added.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint updates the details of an existing drug in both MongoDB and Neo4j. Only users with admin privileges can update drug data.
\nThe request body should contain the following JSON object with the details of the drug to be updated.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint deletes an existing drug from both MongoDB and Neo4j. Only users with admin privileges can delete drug data.
\nThis collection contains all the endpoints that interact with both MongoDB and Neo4j databases. It includes operations that require data manipulation or retrieval from both databases simultaneously, enabling the integration of graphdb and document-based data within the same operations.
\n","event":[{"listen":"prerequest","script":{"id":"4e23bf29-6e44-4504-a425-b883a30d1c50","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"7034f07e-b678-42c5-9ac1-b421981fad39","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"bc170bd5-906b-498c-9683-4d5a2919bf6f","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint registers a new user by providing a username and password. This request is handled securely by sending sensitive information (username and password) via the request body in JSON format.
The request body must contain the following JSON object with the user credentials to register:
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint is used to log in a user to the system. It accepts a username and password via the request body
\nThis endpoint retrieves a list of all users in the system.Only users with admin privileges are authorized to make this request.
\nURL: /admin/users
Description: Fetches a list of all users registered in the system. This includes user details such as their ID, name, and role.
\nThis endpoint retrieves the details of a specific user by their username.Only users with admin privileges are authorized to make this request.
\nURL: /admin/users/{username}
Description: Fetches the details of the user specified by the username parameter. The response includes the user's information such as their ID, name, role, and any other relevant details.
\nThis endpoint retrieves all comments made by users.Only users with admin privileges are authorized to make this request.
\nURL: /admin/users/comments
Description: Fetches all comments made by users, including details such as comment content, user who posted it, and any associated metadata.
\nThis endpoint registers a new admin user with a specified username and password.Only users with admin privileges are authorized to make this request.
\nURL: /admin/registerAdmin
Description: Registers a new admin user by providing a username and password.
\nThe request body should contain the following JSON object with the details of the admin to be created.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"This endpoint removes a comment made by a specific user, identified by the user ID and comment ID.Only users with admin privileges are authorized to make this request.
\nURL: /admin/users/removeComment/{userID}/{commentID}
Description: Removes a comment made by the user specified by userID, with the commentID parameter identifying the specific comment to be deleted.
This endpoint allows an admin to remove a specific user.
\n/users/removeUser/{user}DELETEThis endpoint retrieves all comments made by the currently logged-in user.
\nURL: /profile/my_comments
Description: Fetches all comments made by the user currently logged into the system. The user must be authenticated to access this endpoint.
\nThis endpoint allows the user to add a comment to a specific protein.
\nURL: /profile/add_comment/protein?elementId={proteinId}
Description: Allows the logged-in user to add a comment to the specified protein by providing its unique ID (elementId). The user must be authenticated to access this endpoint.
Existing id
\n","type":"text/plain"},"key":"elementId","value":"P68871"},{"disabled":true,"description":{"content":"this it does not exist
\n","type":"text/plain"},"key":"elementId","value":"P123"},{"key":"elementId","value":"protein_1"}],"variable":[]}},"response":[{"id":"22a002b3-0b2c-4cb5-a80e-3a82d46f288e","name":"Unauthorized access","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"Questo è il mio commento ciao","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/protein?elementId=prova","host":["http://localhost:8080"],"path":["profile","add_comment","protein"],"query":[{"key":"elementId","value":"P68871","description":"id esistente di una proteina o farmaco","disabled":true},{"key":"elementId","value":"prova"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"65"},{"key":"Date","value":"Tue, 28 Jan 2025 09:07:14 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"ErrorCode\": \"9\",\n \"Error\": \"Unauthorized, authentication required\"\n}"},{"id":"12401b03-ad7d-4e81-b8fe-3885e6abfd86","name":"Id does not exist","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"Questo è il mio commento ciao","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/protein?elementId=prova","host":["http://localhost:8080"],"path":["profile","add_comment","protein"],"query":[{"key":"elementId","value":"P68871","description":"id esistente di una proteina o farmaco","disabled":true},{"key":"elementId","value":"prova"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 21 Jan 2025 17:03:41 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"protein with ID: prova does not exist\",\n \"ErrorCode\": \"2\"\n}"},{"id":"6f00d96f-0163-4433-8e7e-f95609b407b9","name":"Correct","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"This is my comment!","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/protein?elementId=P68871","host":["http://localhost:8080"],"path":["profile","add_comment","protein"],"query":[{"key":"elementId","value":"P68871","description":"Existing id"},{"key":"elementId","value":"P123","description":"this it does not exist","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"26"},{"key":"Date","value":"Tue, 21 Jan 2025 17:04:31 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"Comment added successfully"},{"id":"0746e64f-90b7-4277-a76a-a17dab6eab5a","name":"Missing parameter","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"Questo è il mio commento ciao","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/protein","host":["http://localhost:8080"],"path":["profile","add_comment","protein"],"query":[{"key":"elementId","value":"P68871","description":"Existing id","disabled":true},{"key":"elementId","value":"P123","description":"this it does not exist","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 21 Jan 2025 17:05:44 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"Required request parameter 'elementId' for method parameter type String is not present\",\n \"ErrorCode\": \"7\"\n}"}],"_postman_id":"fd511cc0-f2fa-448f-8175-f5e81d74f7c3"},{"name":"addComment drug","id":"ba61cc6d-23c8-4bc9-8393-5aa12168d545","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"This is my comment!","options":{"raw":{"language":"text"}}},"url":"http://localhost:8080/profile/add_comment/drug","description":"This endpoint allows the user to add a comment to a specific drug.
\nURL: /profile/add_comment/drug?elementId={drugId}
Description: Allows the logged-in user to add a comment to the specified drug by providing its unique ID (elementId). The user must be authenticated to access this endpoint.
Existing ID
\n","type":"text/plain"},"key":"elementId","value":"DB00945"},{"disabled":true,"description":{"content":"Absent ID
\n","type":"text/plain"},"key":"elementId","value":"test"}],"variable":[]}},"response":[{"id":"d1c6f07f-ff35-4764-b0bf-cd7778f16cca","name":"Unauthorized access","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"Questo è il mio commento ciao","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/drug?elementId=prova2","host":["http://localhost:8080"],"path":["profile","add_comment","drug"],"query":[{"key":"elementId","value":"P68871","description":"id esistente di una proteina o farmaco","disabled":true},{"key":"elementId","value":"prova2"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"65"},{"key":"Date","value":"Tue, 28 Jan 2025 09:07:23 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"ErrorCode\": \"9\",\n \"Error\": \"Unauthorized, authentication required\"\n}"},{"id":"187e09db-9d8e-490a-acd1-cd3d3e312b9f","name":"ID does not exist","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"Questo è il mio commento ciao","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/drug?elementId=test","host":["http://localhost:8080"],"path":["profile","add_comment","drug"],"query":[{"key":"elementId","value":"P68871","description":"id esistente di una proteina o farmaco","disabled":true},{"key":"elementId","value":"test"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 21 Jan 2025 17:06:44 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"drug with ID: test does not exist\",\n \"ErrorCode\": \"2\"\n}"},{"id":"8b0a480a-cfc2-48f4-b1e7-27e050429037","name":"Correct","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"Questo è il mio commento ciao","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/drug?elementId=DB00945","host":["http://localhost:8080"],"path":["profile","add_comment","drug"],"query":[{"key":"elementId","value":"DB00945","description":"id esistente di una proteina o farmaco"},{"key":"elementId","value":"test","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"26"},{"key":"Date","value":"Tue, 21 Jan 2025 17:07:24 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"Comment added successfully"},{"id":"cc12b28d-1629-4b51-805a-740eb5e219d0","name":"Missing parameter","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"Questo è il mio commento ciao","options":{"raw":{"language":"text"}}},"url":{"raw":"http://localhost:8080/profile/add_comment/drug","host":["http://localhost:8080"],"path":["profile","add_comment","drug"],"query":[{"key":"elementId","value":"DB00945","description":"id esistente di una proteina o farmaco","disabled":true},{"key":"elementId","value":"test","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 21 Jan 2025 17:07:37 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"Required request parameter 'elementId' for method parameter type String is not present\",\n \"ErrorCode\": \"7\"\n}"}],"_postman_id":"ba61cc6d-23c8-4bc9-8393-5aa12168d545"},{"name":"remove comment","id":"ed3d623c-282e-4d9f-b512-76d616ad491a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:8080/profile/removeComment/60652833-236b-412b-91cd-6e44f0d90243","description":"This endpoint allows the user to remove a specific comment.
\nURL: /profile/removeComment/{commentId}
Description: Allows the logged-in user to remove a comment by providing its unique commentId. The user must be authenticated to access this endpoint.
This endpoint allows the logged-in user to delete their account.
\nURL: /profile/deleteAccount
Method: DELETE
Description: Allows the logged-in user to delete their account and all related information. The user must be authenticated to access this endpoint.
\n