ፊደል(Fidel) Tools API Reference

ፊደል(Fidel) Tools is a developer-first suite of high-performance natural language processing APIs built specifically for Ethiopic languages. This reference provides interactive documentation for our production-grade NLP preprocessing endpoints.

Base API Endpoints

All requests must target our active endpoints. Build and test locally using the development server.

Production Base URL

https://api.fidel.tools

Prod not ready yet. Infra under construction.

Local Development Base URL

http://localhost:3001

API Key Authentication

API keys are required for all protected endpoints. Pass your API key in either of these headers:

Custom Header (Preferred)

x-api-key: fidel_dev_key_...

Authorization Header

Authorization: Bearer fidel_dev_key_...

Standard HTTP Response Codes

Code	Status	Description
200	OK	Request completed successfully and returned requested payload data.
400	Bad Request	Validation failed or request JSON body does not match endpoint schemas.
401	Unauthorized	Missing, invalid, or inactive API key passed in headers.
429	Too Many Requests	Rate limit exceeded for developer key or IP address (public rate limiting).
500	Internal Server Error	An unhandled exception or database connection error occurred on the API server.