Docs
About API
About API
Welcome to the Tatry API reference. Our API is organized around REST principles and uses standard HTTP response codes, authentication, and verbs.
Base URL
https://api.tatry.dev/v1
Authentication
All API requests require authentication using your API key. You can authenticate using either our REST API or Python SDK:
Authorization: Bearer your-api-keyfrom tatry import TatryRetriever
# Initialize the client with your API key
client = TatryRetriever(api_key="your-api-key")Available Endpoints
| Category | Base Path | Documentation | Description |
|---|---|---|---|
| Authentication | /v1/auth | View Docs | API key management and validation |
| Retrieval | /v1/retrieve | View Docs | Document search and batch processing |
| Sources | /v1/sources | View Docs | Content source management |
| Usage | /v1/usage /v1/feedback /v1/health | View Docs | Usage statistics and system health |
Integrations
Our Python SDK provides seamless integration with popular frameworks and libraries:
LangChain Integration
The SDK includes several pre-built components that work out-of-the-box with LangChain:
from content_retriever.integrations.langchain import (
TatryRetrieverLangchain
)
# Initialize LLM
llm = ChatOpenAI(temperature=0)
# Create a simple QA chain
qa_chain = RetrievalQA.from_chain_type(
llm=llm,
retriever=retriever,
chain_type="stuff" # Simple document concatenation
)
# Use the chain
response = qa_chain.run("What are the key features of quantum computing?")
print(response)Read more about the Langchain Integration
Testing
Use our sandbox environment for testing:
curl https://sandbox-api.tatry.dev/v1/healthclient = TatryRetriever(
api_key="your-api-key",
base_url="https://sandbox-api.tatry.dev/v1"
)Rate Limits
- 100 requests per minute per API key
- 1000 requests per hour per API key
- Bulk operations count as multiple requests