Allianz Technology Standards logo

Allianz Technology Standards

A collection of technology standards and guidelines maintained by Allianz for software development, API design, architecture, and engineering practices. Allianz follows API-first development using OpenAPI specifications, Backend for Frontends (BFF) architecture, and standardized patterns for pagination, sorting, webhooks, and asynchronous processing.

2 APIs 1 Capabilities 6 Features
Best PracticesEnterprise ArchitectureGuidelinesSoftware DevelopmentTechnology StandardsAPI DesignOpenAPI

APIs

Allianz Trade API Design Standards

Allianz Trade API design guidelines covering REST API conventions, pagination standards (pageSize, page, totalRequired), sorting conventions, asynchronous processing with JobID ...

Allianz Backend Development Standards

Allianz Global Digital Factory backend development standards. Uses Java and Kotlin with Spring Boot for microservices, API-first approach with OpenAPI specifications, Backend fo...

Capabilities

Allianz Standards Compliance Workflow

Workflow capability for architects and developers querying Allianz technology standards and checking API compliance against documented guidelines.

Run with Naftiko

Features

API First Development

Allianz mandates API-first design using OpenAPI specifications before implementation, enabling frontend teams to work with mock servers independently.

Pagination Standards

Standardized pagination using pageSize (default 20), page (default 1), and totalRequired parameters with Total-Items and Total-Pages response headers.

Asynchronous Processing Pattern

JobID-based pattern for POST/PATCH/DELETE operations returning a job identifier that clients poll until status transitions from pending to processed.

Webhook Notification Standards

Standardized webhook patterns with technical and functional notification types, HTTPS requirement, IP whitelisting, and pre-signed URL support.

OAuth2 Security Standard

Allianz Trade APIs standardize on OAuth2 client credentials for programmatic API authentication across all API products.

Backend for Frontends Architecture

BFF pattern where each backend service serves a single frontend, enabling clean separation and independent product team decisions.

Use Cases

API Standards Compliance

Verify that Allianz API implementations conform to documented design guidelines for pagination, sorting, webhooks, and authentication.

Developer Onboarding

Guide new developers on Allianz technology conventions for Java/Kotlin backend services, Spring Boot frameworks, and OpenAPI documentation.

Architecture Review

Use BFF and API-first standards as criteria for architecture reviews and technical decision documentation.

Integrations

OpenAPI Initiative

Allianz follows the OpenAPI Specification as the standard format for API documentation and developer portal integration.

Swagger UI

Swagger UI used to make API documentation live and executable from OpenAPI specifications.

Spring Boot

Spring Boot is the standard framework for delivering Allianz backend services with REST, security, caching, and logging.

Semantic Vocabularies

Allianz Technology Standards Context

8 classes · 24 properties

JSON-LD

API Governance Rules

Allianz Technology Standards API Rules

22 rules · 14 errors 7 warnings 1 info

SPECTRAL

Resources

👥
GitHubOrganization
GitHubOrganization
🔗
Website
Website
📰
Blog
Blog
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary
🔗
NaftikoCapability
NaftikoCapability