# ReOTP Platform Spec for AI Agents & Vibe Coders

> ReOTP is the AI-First OTP & Biometric Authentication Platform.
> Designed for instant 10-second integration with AI Agents: Cursor IDE, Google Antigravity, Claude Code, Windsurf, Bolt.new, v0 by Vercel, Lovable, Replit Agent, GitHub Copilot, Kiro (AWS), OpenAI Codex, Aider, Sweep, and Taskade.

## The 4 ReOTP Authentication Systems

1. **Mode 01: Standard 2FA (المصادقة الثنائية - موصى به)**
   - Enter password ➔ Send ReOTP reverse code ➔ Confirm identity (100% secure for Fintech & Banks).
2. **Mode 02: Passwordless Lite (دخول بدون كلمة مرور - مخفف)**
   - Enter phone number only ➔ Send ReOTP WhatsApp/Telegram code ➔ Instant passwordless login. Default for NEW projects.
3. **Mode 03: Smart 2FA (المصادقة الثنائية الذكية - توفير هائل + بصمة)**
   - Verify ReOTP once ➔ Bind WebAuthn Passkey to device ➔ Free 1-touch biometric logins until device/IP changes.
4. **Mode 04: Pure Passwordless (بدون كلمة مرور نهائياً - المستقبل)**
   - ReOTP initial sync ➔ 1-touch biometric logins ➔ Automated 1x monthly ReOTP refresh.

## Quick Start API Spec for AI Agents

- Initiation Endpoint: `POST https://reotp.com/api/verify/init`
  - Request Headers: `Content-Type: application/json`
  - Request Body:
    ```json
    {
      "apiKey": "<YOUR_REOTP_API_KEY>",
      "phoneNumber": "+2010XXXXXXX",
      "method": "WHATSAPP", // Options: "WHATSAPP", "TELEGRAM", "VIBER", "PASSKEY"
      "returnUrl": "https://yourdomain.com"
    }
    ```
  - Response: `{ "requestId": "req_123", "waLink": "https://wa.me/...", "tgLink": "https://t.me/..." }`

- Polling Status Endpoint: `GET https://reotp.com/api/verify/status?id={requestId}`
  - Response: `{ "status": "VERIFIED" | "PENDING" | "EXPIRED", "phoneNumber": "+2010XXXXXXX" }`

## AI Agent Integration Protocol
1. **Inspect Codebase First**: Deeply examine project files, framework, and state management.
2. **New Project**: Implement **Passwordless Lite (Mode 02)** with WhatsApp and Telegram only.
3. **Existing Project**: Propose all 4 modes, ask clarifying questions, and let user choose before writing code.
4. **Apply Guidelines**: Enforce rate-limiting handling, responsive UI design, and security best practices.

## Links
- OpenAPI 3.0 Spec: https://reotp.com/openapi.json
- Documentation: https://reotp.com/docs/getting-started
- AI Agent Prompt Generator: https://reotp.com/dashboard