HTTP/REST Integration

curl -X POST 'https://test-api.7g.com.au/User/Login' \
  -H 'Content-Type: application/json' \
  -H 'Version: 2.0' \
  -d '{
    "username": "your-username",
    "password": "your-password"
  }'

{
  "accessToken": "eyJxxCJ9.eyJxxxpYyJ9.8Csxx3S-jMxxnv-4Nxxfw",
  "refreshToken": "cZkxxx4Y="
}

// C# Example
var loginTimestamp = DateTime.UtcNow;
var tokenExpiryMinutes = 20; // Configure based on your environment
var tokenExpiryTime = loginTimestamp.AddMinutes(tokenExpiryMinutes);

// Refresh 5 minutes before expiry
var refreshTime = tokenExpiryTime.AddMinutes(-5);

curl -X GET 'https://test-api.7g.com.au/BizEntity?PageSize=10' \
  -H 'Authorization: eYJxxx_your_access_token_here' \
  -H 'Version: 2.0'

curl -X POST 'https://test-api.7g.com.au/User/RefreshToken' \
  -H 'Content-Type: application/json' \
  -H 'Version: 2.0' \
  -d '{
    "refreshToken": "cZkxxx_your_refresh_token_here"
  }'

{
  "result": false,
  "message": "Unauthorized: No authentication token was provided!",
  "data": {}
}

// Resolution: Include Authorization header in request

try
{
    var response = await httpClient.GetAsync("/BizEntity");

    if (response.StatusCode == System.Net.HttpStatusCode.Unauthorized)
    {
        Console.WriteLine("Token expired - refreshing...");
        await RefreshTokenAsync();

        // Retry the request with new token
        response = await httpClient.GetAsync("/BizEntity");
    }

    var result = await response.Content.ReadFromJsonAsync<APIResponse>();

    if (!result.Result)
    {
        Console.WriteLine($"Error: {result.Message}");
    }
}
catch (HttpRequestException ex)
{
    Console.WriteLine($"HTTP error: {ex.Message}");
}

curl -X GET 'https://test-api.7g.com.au/BizEntity?PageSize=10' \
  -H 'Authorization: eYJxxx_your_access_token_here' \
  -H 'Version: 2.0'

using System;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

public class SevenGHttpClient
{
    private readonly HttpClient _httpClient;
    private readonly string _username;
    private readonly string _password;
    private readonly int _tokenExpiryMinutes;

    private string? _accessToken;
    private string? _refreshToken;
    private DateTime _tokenExpiryTime;

    public SevenGHttpClient(string baseUrl, string username, string password, int tokenExpiryMinutes = 20)
    {
        _httpClient = new HttpClient { BaseAddress = new Uri(baseUrl) };
        _httpClient.DefaultRequestHeaders.Add("Version", "2.0");

        _username = username;
        _password = password;
        _tokenExpiryMinutes = tokenExpiryMinutes;
    }

    public async Task<TokenResponse> LoginAsync()
    {
        var loginRequest = new { username = _username, password = _password };
        var response = await _httpClient.PostAsJsonAsync("/User/Login", loginRequest);

        response.EnsureSuccessStatusCode();
        var tokens = await response.Content.ReadFromJsonAsync<TokenResponse>();

        _accessToken = tokens.AccessToken;
        _refreshToken = tokens.RefreshToken;
        _tokenExpiryTime = DateTime.UtcNow.AddMinutes(_tokenExpiryMinutes);

        UpdateAuthorizationHeader();

        return tokens;
    }

    private async Task RefreshTokenIfNeededAsync()
    {
        // Refresh 5 minutes before expiry
        if (DateTime.UtcNow >= _tokenExpiryTime.AddMinutes(-5))
        {
            var refreshRequest = new { refreshToken = _refreshToken };
            var response = await _httpClient.PostAsJsonAsync("/User/RefreshToken", refreshRequest);

            if (response.IsSuccessStatusCode)
            {
                var tokens = await response.Content.ReadFromJsonAsync<TokenResponse>();

                _accessToken = tokens.AccessToken;
                _refreshToken = tokens.RefreshToken;
                _tokenExpiryTime = DateTime.UtcNow.AddMinutes(_tokenExpiryMinutes);

                UpdateAuthorizationHeader();
            }
            else
            {
                // Refresh failed - re-login
                await LoginAsync();
            }
        }
    }

    private void UpdateAuthorizationHeader()
    {
        _httpClient.DefaultRequestHeaders.Remove("Authorization");
        _httpClient.DefaultRequestHeaders.Add("Authorization", _accessToken);
    }

    public async Task<APIResponse> GetAsync(string endpoint)
    {
        await RefreshTokenIfNeededAsync();

        var response = await _httpClient.GetAsync(endpoint);

        // Retry once on 401 (token might have expired between refresh check and request)
        if (response.StatusCode == System.Net.HttpStatusCode.Unauthorized)
        {
            await LoginAsync();
            response = await _httpClient.GetAsync(endpoint);
        }

        return await response.Content.ReadFromJsonAsync<APIResponse>();
    }

    // Add POST, PUT, DELETE methods following same pattern
}

// Response Models (or use standalone DTOs file)
public class TokenResponse
{
    public string AccessToken { get; set; }
    public string RefreshToken { get; set; }
}

public class APIResponse
{
    public bool Result { get; set; }
    public string Message { get; set; }
    public int RecordCount { get; set; }
    public object Data { get; set; }
}

// Initialize client (login happens automatically on first request)
var client = new SevenGHttpClient(
    baseUrl: "https://test-api.7g.com.au",
    username: "your-username",
    password: "your-password",
    tokenExpiryMinutes: 20  // Configure based on your environment
);

// Login
await client.LoginAsync();

// Make requests - token refresh happens automatically
var entities = await client.GetAsync("/BizEntity?PageSize=100");
if (entities.Result)
{
    Console.WriteLine($"Retrieved {entities.RecordCount} entities");
}