# Okapi

> A library for handling API and HTTP errors with ease

Know Your Errors By Sight

## Table of Contents

### Getting Started

- [Introduction](/introduction.md): Learn how Okapi turns API and HTTP errors into a consistent format with type safety, translations, and adapters for your preferred HTTP client
- [Quick Start](/quick-start.md): Install Okapi and start mapping API and HTTP errors to consistent, customizable titles and messages for your application
- [Playground](/playground.md): Try Okapi error handling with different HTTP clients.

### Core concepts

- [API](/api.md): Explore the Okapi API for creating, classifying, and mapping errors, including OkapiError properties and core error-handling functions
- [i18n](/i18n.md): Translate and customize Okapi error titles and messages by error kind or HTTP status, using static translations or runtime resolvers
- [Error Kinds](/error-kinds.md): Understand how Okapi classifies API, HTTP, and transport errors, and define custom error kinds for application-specific behavior
- [Custom Validation Errors](/custom-validation-errors.md): Parse and normalize custom API validation error payloads with Okapi while preserving their TypeScript types across error mappers
- [Types](/types.md): Reference shared Okapi TypeScript types for API responses, error classification, error data, mapper results, and configuration

### Adapters

- [Native Fetch](/adapters/native-fetch.md): Handle native Fetch response errors, network failures, cancellations, and timeouts with type-safe Okapi error mappers
- [Axios](/adapters/axios.md): Map Axios response errors, network failures, cancellations, and timeouts to consistent Okapi errors with customizable titles and messages
- [ofetch](/adapters/ofetch.md): Map ofetch response errors, network failures, and timeouts to consistent Okapi errors with type-safe adapters and customizable messages