SHOUTcast Radio Authhash API - Revision history

Djegg: /* Update Authorisation Key */

2021-11-29T16:31:42Z

‎Update Authorisation Key

2021-11-29T16:31:22Z

‎Create Authorisation Key

2021-11-29T16:25:44Z

‎Update Authorisation Key

2021-11-29T16:25:26Z

‎Update Authorisation Key

2020-05-27T12:14:11Z

‎Supported Genres

2020-05-27T12:13:20Z

‎Additional Resources

2020-05-27T12:12:23Z

‎Additional Resources

2020-05-26T14:05:56Z

‎Create Authorisation Key

2020-04-25T15:29:16Z

‎Introduction

2020-04-24T12:23:33Z

‎Update Authorisation Key

@@ Line 205: / Line 205: @@
 * private - determine if the primary server should be public (0 - default) or not (1)
 * admode - determine whether monetization support is enabled for DNAS v2.4.7 and later (0=off, 1=on)
-* logo - full url of jpg or png station logo (limited to 2mb or 800x800 px). Previously used for Radionomy listings.
+* logo - full url of jpg or png station logo. Previously used for Radionomy listings (limited to 2mb or 800x800 px).
 * callsign - the GUID of station if registered in the Shoutcast RadioManager

@@ Line 111: / Line 111: @@
 * private - determine if the primary server should be public (0 - default) or not (1)
 * admode - determine whether monetization support is enabled for DNAS v2.4.7 and later (0=off, 1=on)
 * callsign - the GUID of station if registered in the Shoutcast RadioManager

@@ Line 204: / Line 204: @@
 * private - determine if the primary server should be public (0 - default) or not (1)
 * admode - determine whether monetization support is enabled for DNAS v2.4.7 and later (0=off, 1=on)
-* logo - full url of jpeg or png station logo (limited to 2mb or 800x800 px). Previously used for Radionomy listings.
+* logo - full url of jpg or png station logo (limited to 2mb or 800x800 px). Previously used for Radionomy listings.
 * callsign - the GUID of station if registered in the Shoutcast RadioManager

@@ Line 204: / Line 204: @@
 * private - determine if the primary server should be public (0 - default) or not (1)
 * admode - determine whether monetization support is enabled for DNAS v2.4.7 and later (0=off, 1=on)
 * callsign - the GUID of station if registered in the Shoutcast RadioManager

@@ Line 298: / Line 298: @@
 |-
 | Metal || Black Metal, Classic Metal, Death Metal, Extreme Metal, Grindcore, Hair Metal, Heavy Metal, Metalcore, Power Metal, Progressive Metal, Rap Metal, Thrash Metal
 |-
 | New Age || Environmental, Ethnic Fusion, Healing, Meditation, Spiritual

@@ Line 246: / Line 246: @@
 * '''primarygenre''' - provides a html select control of the primary genres recognised
-* '''secondarygenre?primarygenre=<genre>''' - provides a html select control of the secondary genres related to the primary genre passed or an empty response if there is no genres found
+* '''secondarygenre?primarygenre=<genre>''' - provides a html select control of the secondary genres related to the primary genre passed or an empty response if there are no genres found
 * '''parentgenre?genre=<genre>''' - provides the name of the parent genre of the passed genre or an empty response if there is no parent genre

@@ Line 244: / Line 244: @@
 * '''states''' - provides provides a html select control containing the USPO state code and a displayable string for each option in the control
-* '''primarygenre''' - provides a html select control of the primary genre's recognised
+* '''primarygenre''' - provides a html select control of the primary genres recognised
-* '''secondarygenre?primarygenre=<genre>''' - provides a html select control of the secondary genre's related to the primary genre passed or an empty response if there is no genres found
+* '''secondarygenre?primarygenre=<genre>''' - provides a html select control of the secondary genres related to the primary genre passed or an empty response if there is no genres found
 * '''parentgenre?genre=<genre>''' - provides the name of the parent genre of the passed genre or an empty response if there is no parent genre
@@ Line 351: / Line 351: @@
 Additionally, stationnames just containing punctuation are not allowed as well as any which specify a name which matches with the supported genres (see [[SHOUTcast_Radio_Authhash_API#Supported_Genres|section 4.2]]).
 ==Status Codes==

@@ Line 104: / Line 104: @@
 * website - related url for station up to 128 characters
-* description - brief description about the station up to 65535 characters (replace non-latin/non-alphanumeric characters with [https://www.degraeve.com/reference/urlencoding.php url-encoded] equivalents)
+* description - brief description about the station up to 65535 characters (replace non-latin/non-alphanumeric characters with [https://www.degraeve.com/reference/urlencoding.php url-encoded] equivalents, e.g. & = %26)
 * stateiso - USPO state code (only used if countryiso = US) and defaults to 00 (general)
 * city - more specific place where the stream is based or related up to 128 characters

← Older revision		Revision as of 15:29, 25 April 2020
Line 8:		Line 8:
	The API which is documented here is provided as a means for registered developers to be able to obtain and manage any authorisation keys for the station(s) they are providing.		The API which is documented here is provided as a means for registered developers to be able to obtain and manage any authorisation keys for the station(s) they are providing.

		+	The API works for generating and editing a 20 character v2.x authhash for DNAS v2.5.5 and earlier.
		+	It will not work for editing the 32 character GUID-style authhash used in DNAS v2.6, although v2.6.0.753 does now accept a v2.5x authhash.

	==API Overview==		==API Overview==

@@ Line 199: / Line 199: @@
 * city - more specific place where the stream is based or related up to 128 characters
 * keywords - separated tag words about the stream up to 120 characters
 * private - determine if the primary server should be public (0 - default) or not (1)
   It is recommended to fill in as many of these optional details where possible
@@ Line 207: / Line 210: @@
 Returns a '''basic''' success response or the standard error response.
 ===Remove Authorisation Key===