pinme-email

1# PinMe Worker Email API Integration
2 
3Guides how to call PinMe platform's email sending API in a PinMe Worker (TypeScript).
4 
5## Environment Variables
6 
7The following environment variables are automatically injected when the Worker is created — no manual configuration needed:
8 
9```typescript
10// backend/src/worker.ts
11export interface Env {
12  DB: D1Database;
13  API_KEY: string;      // Project API Key — used for send_email authentication
14  BASE_URL?: string;    // Optional override for PinMe API base URL, defaults to https://pinme.cloud
15}
16```
17 
18> `API_KEY` is the sole credential for the Worker to call PinMe platform APIs. When `BASE_URL` is not set, it defaults to `https://pinme.cloud`.
19 
20---
21 
22## Send Email API
23 
24**Endpoint:** `POST {BASE_URL}/api/v4/send_email`
25**Authentication:** `X-API-Key` header (using `env.API_KEY`)
26**Sender:** Automatically set to `{project_name}@pinme.cloud`
27 
28### Request Format
29 
30```json
31{
32  "to": "user@example.com",
33  "subject": "Your verification code",
34  "html": "<p>Your code is <strong>123456</strong></p>"
35}
36```
37 
38| Field | Type | Required | Description |
39|-------|------|----------|-------------|
40| `to` | string | Yes | Recipient email address |
41| `subject` | string | Yes | Email subject |
42| `html` | string | Yes | HTML body |
43 
44### Response Format
45 
46**Success (200):**
47```json
48{ "code": 200, "msg": "ok", "data": { "ok": true } }
49```
50 
51**Errors:**
52 
53| HTTP Status | Meaning | data.error Example |
54|-------------|---------|-------------------|
55…