Use APi v3 by default, and fall back to v2 in case of not found errors

src/api/services/ShlinkApiClient.ts

@@ -1,5 +1,5 @@
 import { isEmpty, isNil, reject } from 'ramda';
-import { AxiosInstance, AxiosResponse, Method } from 'axios';
+import { AxiosError, AxiosInstance, AxiosResponse, Method } from 'axios';
 import { ShortUrl, ShortUrlData } from '../../short-urls/data';
 import { OptionalString } from '../../utils/utils';
 import {
@@ -17,10 +17,12 @@ import {
   ShlinkDomainRedirects,
   ShlinkShortUrlsListParams,
   ShlinkShortUrlsListNormalizedParams,
+  ProblemDetailsError,
 } from '../types';
 import { orderToString } from '../../utils/helpers/ordering';
+import { isRegularNotFound } from '../utils';
 
-const buildShlinkBaseUrl = (url: string) => (url ? `${url}/rest/v2` : '');
+const buildShlinkBaseUrl = (url: string, version: 2 | 3) => `${url}/rest/v${version}`;
 const rejectNilProps = reject(isNil);
 const normalizeOrderByInParams = (params: ShlinkShortUrlsListParams): ShlinkShortUrlsListNormalizedParams => {
   const { orderBy = {}, ...rest } = params;
@@ -29,11 +31,14 @@ const normalizeOrderByInParams = (params: ShlinkShortUrlsListParams): ShlinkShor
 };
 
 export class ShlinkApiClient {
+  private apiVersion: 2 | 3;
+
   public constructor(
     private readonly axios: AxiosInstance,
     private readonly baseUrl: string,
     private readonly apiKey: string,
   ) {
+    this.apiVersion = 3;
   }
 
   public readonly listShortUrls = async (params: ShlinkShortUrlsListParams = {}): Promise<ShlinkShortUrlsResponse> =>
@@ -118,10 +123,19 @@ export class ShlinkApiClient {
   private readonly performRequest = async <T>(url: string, method: Method = 'GET', query = {}, body = {}): Promise<AxiosResponse<T>> =>
     this.axios({
       method,
-      url: `${buildShlinkBaseUrl(this.baseUrl)}${url}`,
+      url: `${buildShlinkBaseUrl(this.baseUrl, this.apiVersion)}${url}`,
       headers: { 'X-Api-Key': this.apiKey },
       params: rejectNilProps(query),
       data: body,
       paramsSerializer: { indexes: false },
+    }).catch((e: AxiosError<ProblemDetailsError>) => {
+      if (!isRegularNotFound(e.response?.data)) {
+        throw e;
+      }
+
+      // If we capture a not found error, let's assume this Shlink version does not support API v3, so we decrease to
+      // v2 and retry
+      this.apiVersion = 2;
+      return this.performRequest(url, method, query, body);
     });
 }

src/api/types/index.ts

@@ -120,3 +120,8 @@ export interface InvalidShortUrlDeletion extends ProblemDetailsError {
   type: 'INVALID_SHORTCODE_DELETION' | 'INVALID_SHORT_URL_DELETION';
   threshold: number;
 }
+
+export interface RegularNotFound extends ProblemDetailsError {
+  type: 'NOT_FOUND';
+  status: 404;
+}

src/api/utils/index.ts

@@ -1,5 +1,5 @@
 import { AxiosError } from 'axios';
-import { InvalidArgumentError, InvalidShortUrlDeletion, ProblemDetailsError } from '../types';
+import { InvalidArgumentError, InvalidShortUrlDeletion, ProblemDetailsError, RegularNotFound } from '../types';
 
 export const parseApiError = (e: AxiosError<ProblemDetailsError>) => e.response?.data;
 
@@ -8,3 +8,6 @@ export const isInvalidArgumentError = (error?: ProblemDetailsError): error is In
 
 export const isInvalidDeletionError = (error?: ProblemDetailsError): error is InvalidShortUrlDeletion =>
   error?.type === 'INVALID_SHORTCODE_DELETION' || error?.type === 'INVALID_SHORT_URL_DELETION';
+
+export const isRegularNotFound = (error?: ProblemDetailsError): error is RegularNotFound =>
+  error?.type === 'NOT_FOUND' && error?.status === 404;