# CODEFORGE TECHNOLOGIES & SOLUTIONS API Documentation

Welcome to the official developer and agent documentation for **CODEFORGE TECHNOLOGIES & SOLUTIONS** (`https://thecodeforge.in`).
**GSTIN**: `07GRYPM1156G1Z9`

---

## Base URL
```
https://thecodeforge.in/api/v1
```

## Discovery Endpoints (RFC 9727 & AI Agent Ready)
- **API Catalog (RFC 9727)**: `/.well-known/api-catalog`
- **OpenAPI 3.1 JSON**: `/docs/openapi.json`
- **OpenAPI 3.1 YAML**: `/docs/openapi.yaml`
- **MCP Server Card**: `/.well-known/mcp/server-card.json`
- **Agent Skills**: `/.well-known/agent-skills/index.json`
- **ARD Manifest**: `/.well-known/ai-catalog.json`
- **Auth Specification**: `/auth.md`

---

## Endpoints

### 1. Health Check
`GET /health`

**Response (`application/json`)**:
```json
{
  "status": "ok",
  "timestamp": "2026-09-01T10:00:00Z"
}
```

---

### 2. Services List
`GET /services`

Returns available engineering capabilities across Blockchain & Web3, AI/ML, ERPNext, Cloud, and OCR Automation.

**Response (`application/json`)**:
```json
[
  {
    "id": "blockchain-web3",
    "title": "Blockchain, Web3 & Smart Contracts",
    "category": "Blockchain & Web3",
    "technologies": ["Solidity", "Rust", "Ethereum", "Polygon", "Solana"]
  },
  {
    "id": "ai-ml",
    "title": "Machine Learning & Deep Learning AI",
    "category": "AI & Machine Learning",
    "technologies": ["PyTorch", "TensorFlow", "FastAPI", "Python"]
  }
]
```

---

### 3. Project Estimate Request
`POST /quotes/estimate`

Submit project requirements to receive timeline milestones and architectural scoping.

**Request Body (`application/json`)**:
```json
{
  "projectType": "blockchain-dapp",
  "requirements": [
    "Solidity ERC-20 tokenomics",
    "Automated liquidity staking contract",
    "Security audit & verification"
  ],
  "clientEmail": "developer@example.com"
}
```

---

## Authentication & Headers
- Header: `Authorization: Bearer <token>` (See `/auth.md` for details)
- Content negotiation for agents: Send `Accept: text/markdown` to retrieve human/agent readable documentation.