{"id":26678274,"url":"https://github.com/telexintegrations/barrzupdate","last_synced_at":"2025-03-26T05:15:20.957Z","repository":{"id":278971955,"uuid":"937197222","full_name":"telexintegrations/BarrzUpdate","owner":"telexintegrations","description":"API integrated with Telex that retrieves a list of latest music releases across genres from the Spotify API","archived":false,"fork":false,"pushed_at":"2025-02-22T21:15:16.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-22T22:22:39.640Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","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/telexintegrations.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-22T15:11:49.000Z","updated_at":"2025-02-22T21:15:19.000Z","dependencies_parsed_at":"2025-02-22T22:22:43.588Z","dependency_job_id":"6636d9b8-745a-4eed-88cf-5ac52fb63418","html_url":"https://github.com/telexintegrations/BarrzUpdate","commit_stats":null,"previous_names":["telexintegrations/barrzupdate"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FBarrzUpdate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FBarrzUpdate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FBarrzUpdate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2FBarrzUpdate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telexintegrations","download_url":"https://codeload.github.com/telexintegrations/BarrzUpdate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245591533,"owners_count":20640692,"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":"2025-03-26T05:15:20.510Z","updated_at":"2025-03-26T05:15:20.943Z","avatar_url":"https://github.com/telexintegrations.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spotify Telex Integration API Documentation\n\n## Overview\nThis API retrieves the latest music releases across genres from Spotify and integrates with Telex, a notification system that calls this API and sends updates to a designated Telex channel.\n\n## Prerequisites\n- .NET 6 or later installed\n- A Spotify API key\n- Telex integration configured\n\n## Setup\n1. Clone the repository:\n   ```sh\n   git clone \u003crepository-url\u003e\n   cd \u003cproject-directory\u003e\n   ```\n2. Restore dependencies:\n   ```sh\n   dotnet restore\n   ```\n3. Configure environment variables:\n   - `SPOTIFY_CLIENT_ID`: Your Spotify client ID\n   - `SPOTIFY_CLIENT_SECRET`: Your Spotify client secret\n   - `TELEX_WEBHOOK`: Your Telex webhook\n4. Run the API:\n   ```sh\n   dotnet run\n   ```\n\n## Base URL\n```\nhttps://baseURL\n```\n\n## Endpoints\n### 1. API Health Check\n**Endpoint:**\n```\nGET /\n```\n**Response:**\n```json\n{\n  \"message\": \"API is active - {token}\",\n  \"status\": 200\n}\n```\n\n### 2. Get Telex Integration Config\n**Endpoint:**\n```\nGET /integration.json\n```\n**Response:**\n```json\n{\n  \"data\":{}\n}\n```\n\n### 3. Get Latest Music Releases\n**Endpoint:**\n```\nGET /GetLatestBarrz\n```\n**Response:**\n```json\n[\n  \"Artist1 - Song1\",\n  \"Artist2 - Song2\",\n  \"Artist3 - Song3\"\n]\n```\n**Status Code:** `200`\n\n### 4. Receive Telex Message\n**Endpoint:**\n```\nPOST /tick\n\n- sample url : https://hng12.bsite.net/tick\n```\n**Sample Request Body:**\n```json\n{\n  \"channel_id\": \"01952b42-efee-711d-bf7e-314d1942b740\",\n  \"return_url\": \"https://ping.telex.im/v1/webhooks/01952b42-efee-711d-bf7e-314d1942b740\",\n  \"settings\" : [\n    {\n      \"label\" : \"interval\",\n      \"type\" : \"text\",\n      \"required\" : true,\n      \"default\" : \"0 8 * * 1-6\"\n    }\n  ]\n}\n```\n**Response:**\n```json\n{\n  \"status\": \"Accepted\"\n}\n```\n**Status Code:** `202`\n\n## License\nThis project is open-source and available under the MIT License.\n\n## Author\nDeveloped by BahdMan.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fbarrzupdate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelexintegrations%2Fbarrzupdate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fbarrzupdate/lists"}