{"id":18671922,"url":"https://github.com/karn/sonar.api","last_synced_at":"2025-11-06T21:30:36.459Z","repository":{"id":86549090,"uuid":"41955140","full_name":"Karn/Sonar.API","owner":"Karn","description":null,"archived":false,"fork":false,"pushed_at":"2015-11-23T02:49:51.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-27T19:28:07.660Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Karn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-05T09:03:37.000Z","updated_at":"2015-09-20T11:30:58.000Z","dependencies_parsed_at":"2023-03-09T23:12:58.841Z","dependency_job_id":null,"html_url":"https://github.com/Karn/Sonar.API","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karn%2FSonar.API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karn%2FSonar.API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karn%2FSonar.API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karn%2FSonar.API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Karn","download_url":"https://codeload.github.com/Karn/Sonar.API/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239512821,"owners_count":19651312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T09:08:31.317Z","updated_at":"2025-11-06T21:30:36.423Z","avatar_url":"https://github.com/Karn.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Sonar.API\n\nSonar is a hyper local music discovery platform. Sonar provides an outlet for emargin artists to share their music and grow their fan base. Alternatively, the music enthusiast can find new and talented artists who are looking to break out.\nThe Sonar API provides the infrastructure for all the data storage and retrival. The API uses NodeJS as well as MongoDB.\n\n### Usage\n\nThe service provides various endpoints from which relevant data can be accessed and created/updated.\n\n\nReturns a collection of users within the database.\n```\nGET: /api/users\n```\n\nReturns a user with the specified id from the database.\n```\nGET: /api/users/:id\n\nPARAMS: id (integer)\n```\n\nCreates a user object and adds it to the Users table.\n```\nPOST: /api/users\n\nBODY: id (integer), name (string), description (string), city (string), state (string).\n```\n\nAdds a user (other_user) to the list of accounts being followed by this (id) user.\n```\nGET: /api/users/:id/follow/:other_id\n\nPARAMS: id (integer), other_id (integer)\n```\n\nRemoves a user (other_user) from the list of accounts being followed by this (id) user.\n```\nGET: /api/users/:id/unfollow/:other_id\n\nPARAMS: id (integer), other_id (integer)\n```\n\nAllows a user with the given id to like a given track.\n```\nGET: /api/users/:id/like\n\nPARAMS: id (integer)\nQUERY: track_id (integer)\n```\n\n\nAllows a user with the given id to unlike a given track.\n```\nGET: /api/users/:id/unlike\n\nPARAMS: id (integer)\nQUERY: track_id (integer)\n```\n\nReturns a collection of users that are being followed.\n```\nGET: /api/users/:id/following\n\nPARAMS: id (integer)\n```\n\nReturns a collection of users that are following a given blog.\n```\nGET: /api/users/:id/followers\n\nPARAMS: id (integer)\n```\n\nReturns a collection of users which have been  'starred' by the user.\n```\nGET: /api/users/:id/starred_artists\n\nPARAMS: id (integer)\n```\n\nReturn a collection of tracks which have been liked by a given user.\n```\nGET: /api/users/:id/liked_tracks\n\nPARAMS: id (integer)\n```\n\nReturn a collection of tracks uploaded by a given user.\n```\nGET: /api/users/:id/tracks\n\nPARAMS: id (integer)\n```\n\nAllows for the creation of a track object.\n```\nPOST: /api/tracks/create\n\nBODY: id (integer), name (string), description (string), city (string), state (string), source (string).\n```\n\nReturn track by its id.\n```\nGET: /api/tracks/:id\n\nPARAMS: id (integer)\n```\n\nReturns a collection of the latest uploaded tracks.\n```\nGET: /api/feed/new\n\nQUERY: city (string), state (string)\n```\n\nReturns a collection of tracks that have the most amount of likes.\n```\nGET: /api/feed/hot\n\nQUERY: city (string), state (string)\n```\n\nReturns a collection of tracks that have been uploaded by users being followed by the given user.\n```\nGET: /api/users/:id/following_tracks\n\nQUERY: id (interger)\n```\n\nSearch for a particular song or artist\n```\nGET: /api/search\n\nQUERY: filter (string) where \"users\" filters by users.\n```\n\n### License\nGitTracker is released under the The GNU General Public License v3.0 (GPLv3), which can be found in the LICENSE file in the root of this project.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarn%2Fsonar.api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarn%2Fsonar.api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarn%2Fsonar.api/lists"}