Skip to main content

API Integration Testing & Debugging Guide

SDD Classification: L4-Operational | Authority: Engineering Lead + QA Lead | Review Cycle: Monthly
This document provides comprehensive guidance for API integration testing and debugging across the Materi platform. It covers testing strategies, debugging tools, common issues, and resolution patterns for backend services. Primary Stack: Go Fiber, Rust Axum, Python Django Testing Frameworks: testify (Go), tokio-test (Rust), pytest (Python) Debugging Tools: Delve, rust-gdb/rust-lldb, pdb, OpenTelemetry

Integration Testing Architecture

Testing Pyramid for API Services


Service-Specific Testing

Go (API Service) Testing

Test Structure

Integration Test with Real Database

Rust (Relay Service) Testing

Python (Shield Service) Testing


API Debugging Techniques

Request/Response Debugging

Go API Debugging

Using Delve for Go Debugging

Distributed Tracing


Common Integration Issues

Issue Resolution Matrix

Database Connection Issues


Test Commands Reference

Go API Testing

Rust Relay Testing

Python Shield Testing



Document Status: Complete Version: 2.0 Last Updated: January 2026 Authority: Engineering Lead + QA Lead Classification: L4-Operational - Developer Reference Distribution: Engineering Teams