Developer Portal

Build with Microzen APIs. Access our OpenAPI specification, authentication guides, and quickstart examples to integrate our AI assistant, contact forms, and service generation.

📄

OpenAPI Specification

Complete machine-readable API specification (OpenAPI 3.1.0) with all endpoints, schemas, and examples. Use with code generators, API clients, and documentation tools.

🔍

API Reference

Browse interactive API documentation with request/response examples, authentication details, and rate limit information for all endpoints.

Quickstart Guide

Get Your CSRF Token

All mutating endpoints require a CSRF token. Fetch it from `/api/csrf` and include it in the `x-csrf-token` header.

curl -X GET https://microzentechnologies.com/api/csrf
# Response: {"token": "abc123..."}

Make Authenticated Requests

Include the CSRF token in the `x-csrf-token` header for all POST requests.

curl -X POST https://microzentechnologies.com/api/chat \
  -H "Content-Type: application/json" \
  -H "x-csrf-token: YOUR_CSRF_TOKEN" \
  -d '{"message": "Tell me about your AI services"}'

Handle Rate Limits

Responses include rate limit headers. Respect `X-RateLimit-Remaining` and retry after `X-RateLimit-Reset` when exceeded.

# Headers returned:
X-RateLimit-Limit: 10
X-RateLimit-Remaining: 9
X-RateLimit-Reset: 1700000000

API Endpoints

POST/api/chat

Chat Completion

Auth: CSRF TokenRate: 10 req/min

Send messages to Zen, our AI Digital Twin. Get answers about services, AIOutreach product, careers, and company information.

POST/api/contact

Contact Form

Auth: CSRF TokenRate: 5 req/5min

Submit project inquiries with optional callback scheduling. Sends notification to our team and auto-reply to submitter.

POST/api/apply

Job Application

Auth: CSRF TokenRate: 3 req/5min

Submit job applications with resume upload (multipart/form-data). Sends application to hiring team via email.

POST/api/newsletter

Newsletter Subscription

Auth: CSRF TokenRate: 5 req/5min

Subscribe email addresses to the Microzen newsletter.

POST/api/generate-service

Generate Service Roadmap

Auth: CSRF TokenRate: 5 req/min

AI-powered personalized service roadmap generation for specific project topics. Returns structured proposals with problems, solutions, capabilities, and case studies.

GET/api/csrf

Get CSRF Token

Auth: NoneRate: Unlimited

Obtain a CSRF token required for all mutating endpoints. Token is also set as HttpOnly cookie.

SDKs & Tools

OpenAPI Spec

Machine-readable API specification (OpenAPI 3.1.0)

TypeScript Types

Auto-generated types from OpenAPI spec

Postman Collection

Ready-to-use Postman collection for testing

Authentication

CSRF Token Authentication

All mutating endpoints (POST) require a CSRF token for protection against cross-site request forgery. The token is obtained via a separate endpoint and must be included in the request header.

Flow:

Call GET /api/csrf to get a token
Include token in x-csrf-token header for POST requests
Token is also set as HttpOnly cookie microzen-csrf-token

Rate Limiting

All endpoints implement rate limiting per IP address. Limits vary by endpoint:

Chat: 10 requests per minute
Contact: 5 requests per 5 minutes
Apply: 3 requests per 5 minutes
Newsletter: 5 requests per 5 minutes
Generate Service: 5 requests per minute

Rate limit headers are included in all responses:X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset (Unix timestamp).

Error Handling

All endpoints return structured JSON error responses:

{
  "error": "Human-readable error message",
  "details": ["Optional validation error details"]
}

Common HTTP Status Codes:

400 — Invalid request payload
403 — Invalid or missing CSRF token
429 — Rate limit exceeded
500 — Internal server error
503 — AI service temporarily unavailable
504 — Request timeout