Compatibility & Prerequisites

This page describes the compatibility between Platina Standard API versions, Platina Core, and infrastructure requirements.

⚠️ Important: Always verify that your Platina Core version is compatible with the API version you are installing. Installing an incompatible API version may cause runtime errors or data issues.

Platina Core ↔ API Version Matrix

API Version API Type Min Core Version Max Core Version .NET Runtime Authentication Release Date
8.0.0 REST ≥ ?.?.? — .NET 8 (ASP.NET Core 8.0.21+) OAuth 2.0 / Azure AD 2025-05-09
7.1.1 REST ≥ ?.?.? — ASP.NET Core Windows 2025-03-14
7.1.0 REST ≥ ?.?.? — ASP.NET Core Windows 2024-10-24
7.0.0 REST ≥ ?.?.? — ASP.NET Core Windows 2024-02-26
6.0.1 WCF ≥ ?.?.? — .NET Framework 4.8 Windows 2023-09-22
6.0.0 WCF ≥ ?.?.? — .NET Framework 4.8 Windows 2021-12-06
5.1.0 WCF ≥ ?.?.? — .NET Framework 4.8 Windows 2021-02-17
5.0.0 WCF ≥ ?.?.? — .NET Framework 4.8 Windows 2020-09-30
4.1.0 WCF ≥ ?.?.? — .NET Framework 4.8 Windows 2020-09-29
4.0.0 WCF ≥ ?.?.? — .NET Framework 4.8 Windows 2020-05-01
3.0.0 WCF ≥ ?.?.? — .NET Framework 4.8 Windows 2020-01-31

📝 Contributors: Replace ?.?.? with the actual minimum Platina Core version for each API release. Add an upper bound in "Max Core Version" if the API is known to be incompatible with newer Core versions.

SQL Server Compatibility

API Version Min SQL Server Notes
8.0.0 TBD
7.x TBD
6.x and earlier TBD

Breaking Changes Between Major Versions

WCF → REST (v6.x → v7.0)

The move from v6.x to v7.0 is a platform migration, not an upgrade:

Aspect Legacy WCF (v3–v6) REST API (v7+)
Protocol WCF / SOAP / net.tcp HTTP / REST / JSON
Contracts WSDL OpenAPI (Swagger)
Hosting IIS + WCF services + MsDeploy IIS + ASP.NET Core Module
Authentication Windows (Kerberos/NTLM) Windows (v7.x) or OAuth 2.0 (v8+)
Transport TCP port 808 HTTPS port 443
Payload format XML JSON
API standard Proprietary DIGG REST API profile

⚠️ Existing WCF integrations cannot be migrated in-place. A new integration must be developed using the REST API.

REST v7.x → v8.0

Aspect v7.x v8.0
.NET Runtime ASP.NET Core .NET 8 (hosting bundle required)
Authentication Windows OAuth 2.0 / Azure AD only — Windows auth removed
Multi-tenant No Yes

⚠️ Windows authentication is no longer supported starting with API 8.0.0. You must configure Azure AD app registration. See the Authorization guide.

Infrastructure Requirements

REST API (v7.0+)

  • Web server: IIS (recommended) with the ASP.NET Core Hosting Bundle
  • Runtime: .NET 8 for API 8.0+; ASP.NET Core for API 7.x
  • SQL Server: Platina database with API stored procedures installed
  • Network: HTTPS (port 443 recommended)
  • Authentication (v8.0+): Azure AD tenant with app registration

Required environment variables

Variable Description
DB_SERVER SQL Server hostname
DB_TRUSTED_CONNECTION Use Windows integrated auth for DB (true/false)
DB_USER SQL login username (if not using trusted connection)
DB_PASSWORD SQL login password (if not using trusted connection)
PLATINA_API_USERNAME Platina service account username
PLATINA_API_BASE_URL Base URL for the API

Legacy WCF API (v3–v6)

  • Web server: IIS with ASP.NET 4.8, WCF activation components
  • Runtime: .NET Framework 4.8
  • SQL Server: Platina database
  • Network: HTTP (port 80) + TCP (port 808)
  • Firewall rule: "Windows Communication Foundation Net.TCP Listener Adapter (TCP-In)"
  • Deployment: MsDeploy
  • Service account: Domain user configured as StandardServiceAuthorizedUser in Platina