# Android Networking

> Standards for Retrofit, OkHttp, and API Communication

- Skill: `majiayu000/android-networking` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/android-networking`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/android-networking/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/android-networking

---


# Android Networking Standards

## **Priority: P0**

## Implementation Guidelines

### Libraries

- **Client**: Retrofit 2 + OkHttp 4.
- **Serialization**: Kotlinx Serialization (Preferred over Moshi/Gson).
- **Format**: JSON. Use `@SerialName` for field mapping.

### Best Practices

- **Interceptors**: Use for Auth Headers (Bearer Token) and Logging (`HttpLoggingInterceptor`).
- **Response Handling**: Wrap responses in a `Result` type (Success/Error/Loading) in Repository/DataSource, NOT in the API interface.
- **Threads**: API calls must be `suspend` functions.

## Anti-Patterns

- **Main Thread**: `**No Blocking Calls**: Use suspend.`
- **Logic in API**: `**No Logic in Interface**: Only definitions.`
- **Missing Content-Type**: `**No Raw Factory**: When using kotlinx.serialization, always explicitly specify "application/json" MediaType in your converter factory.`

## References

- [Setup & Wrappers](references/implementation.md)