Version 1.0.0

Author: Jedlix

README.md

@@ -14,19 +14,20 @@ Add the following to your `build.gradle`:
 
 ```groovy
 dependencies {
-    implementation("com.jedlix:sdk:1.6.1")
+    implementation("com.jedlix:sdk:1.7.0")
 }
 ```
 
 ## Usage
 
-When you sign up for a [Smart Charging API](https://api.jedlix.com/) account, you get a custom `baseURL` and `apiKey`. Configure the SDK with these values and an `Authentication` implementation. API key is not required if you use your own base URL.
+When you sign up for a [Smart Charging API](https://api.jedlix.com/) account, you get a custom `baseURL` and `apiKey`. Configure the SDK with these values and an `Authentication` implementation. You can also provide custom HTTP headers. API key is not required if you use your own base URL.
 
 ```kotlin
 import com.jedlix.sdk.JedlixSDK
 
 JedlixSDK.configure(
     /* Base URL */,
+    /* Headers */,
     /* API key */,
     /* Authentication implementation */
 )

example/build.gradle.kts

@@ -83,7 +83,7 @@ dependencies {
 
     val exampleAsMavenLocal: String by project
     if (exampleAsMavenLocal.toBoolean()) {
-        implementation("com.jedlix:sdk:1.6.1")
+        implementation("com.jedlix:sdk:1.7.0")
     } else {
         implementation(project(":sdk"))
     }

example/src/main/java/com/jedlix/sdk/example/ExampleApplication.kt

@@ -51,9 +51,9 @@ class ExampleApplication : Application() {
 //            this
 //        )
         JedlixSDK.configure(
-            baseURL,
-            apiKey,
-            authentication
+            baseURL = baseURL,
+            apiKey = apiKey,
+            authentication = authentication
         )
     }
 

gradle.properties

@@ -17,5 +17,5 @@ androidxLifecycleVersion=2.6.1
 androidxBrowserVersion=1.5.0
 dokkaVersion=1.8.10
 
-sdkVersion=1.6.1
+sdkVersion=1.7.0
 exampleAsMavenLocal=false

sdk/src/main/java/com/jedlix/sdk/JedlixSDK.kt

@@ -31,10 +31,10 @@ import java.util.concurrent.atomic.AtomicReference
 class JedlixSDK private constructor(
     private val host: String = "",
     private val basePath: String = "",
+    private val headers: Map<String, String>,
     private val apiKey: String?,
     private val authentication: Authentication
 ) {
-
     /**
      * Sets the log level of the Jedlix SDK. Defaults to [ERRORS]
      */
@@ -60,11 +60,13 @@ class JedlixSDK private constructor(
         /**
          * Initializes the SDK with the specified parameters.
          * @param baseURL Base [URL] of the Smart Charging API
+         * @param headers HTTP headers provided to each request
          * @param apiKey API key associated with the developer account
          * @param authentication An object providing access token to the API
          */
         fun configure(
             baseURL: URL,
+            headers: Map<String, String> = emptyMap(),
             apiKey: String? = null,
             authentication: Authentication
         ): JedlixSDK {
@@ -74,6 +76,7 @@ class JedlixSDK private constructor(
                     JedlixSDK(
                         baseURL.host,
                         baseURL.path.substringBefore(EndpointBuilder().path),
+                        headers,
                         apiKey,
                         authentication
                     )
@@ -102,6 +105,7 @@ class JedlixSDK private constructor(
                 KtorApi(
                     host,
                     basePath,
+                    headers,
                     apiKey,
                     authentication
                 )

sdk/src/main/java/com/jedlix/sdk/networking/Api.kt

@@ -80,6 +80,7 @@ abstract class Api {
 
     protected abstract val host: String
     protected abstract val basePath: String
+    protected abstract val headers: Map<String, String>
     protected abstract val apiKey: String?
     protected abstract val authentication: Authentication
 
@@ -88,11 +89,11 @@ abstract class Api {
         HEADER_AUTHORIZATION to authentication.getAccessToken()
             ?.let { AUTHORIZATION_FORMAT.format(it) },
         HEADER_ACCEPT_LANGUAGE to Locale.getDefault().toLanguageTag(),
-        HEADER_CLIENT_VERSION to "1.5.0",
+        HEADER_CLIENT_VERSION to "1.7.0",
         HEADER_CORRELATION_ID to UUID.randomUUID().toString()
     )
         .mapNotNull { (key, value) -> value?.let { key to it } }
-        .toMap()
+        .toMap() + headers
 
     /**
      * Requests an [EndpointNode] for a [Response] of type [Result]

sdk/src/main/java/com/jedlix/sdk/networking/KtorApi.kt

@@ -47,6 +47,7 @@ import kotlinx.serialization.builtins.serializer
 internal class KtorApi(
     override val host: String,
     override val basePath: String,
+    override val headers: Map<String, String>,
     override val apiKey: String?,
     override val authentication: Authentication
 ) : Api() {