# PlatPhorm Site Registration API

> Register and manage sites in the PlatPhorm News trusted network

## Overview

The PlatPhorm Site Registration API enables secure onboarding of new sites into the PlatPhorm ecosystem. It provides trust verification, API key management, and integration with network services.

## Base URL

https://register.platphormnews.com/api/v1

## Authentication

All authenticated endpoints require an API key passed in the X-API-Key header:

```
X-API-Key: pk_your_api_key_here
```

## Core Endpoints

### Registration

- POST /registrations - Create a new site registration
- GET /registrations - List your registrations
- GET /registrations/{id} - Get registration details
- PATCH /registrations/{id} - Update registration
- DELETE /registrations/{id} - Cancel registration (admin only)

### Verification

- POST /registrations/{id}/verify/dns - Verify domain via DNS TXT record
- POST /registrations/{id}/verify/email - Verify contact email
- GET /registrations/{id}/verify/email - Resend verification email

### Trust Assessment

- GET /registrations/{id}/trust - Get current trust assessment
- POST /registrations/{id}/trust - Request trust reassessment

### Webhooks

- GET /webhooks - List webhook endpoints
- POST /webhooks - Create webhook endpoint

### Events

- GET /events - List events (outbox pattern)
- POST /events - Acknowledge processed events

### System

- GET /health - Health check endpoint
- GET /docs - OpenAPI specification

## Trust Levels

Sites are assigned trust levels based on verification status:

| Level | Name | Score | Capabilities |
|-------|------|-------|--------------|
| 0 | Pending | 0-19 | Basic registration |
| 1 | Basic | 20-39 | RSS access, basic API |
| 2 | Verified | 40-59 | Full API, webhooks |
| 3 | Trusted | 60-79 | LLM access, MCP integration |
| 4 | Premium | 80-100 | All features, featured listing |

## Trust Score Factors

- DNS Verification: +15 points
- SSL Certificate: +10 points
- Email Verification: +10 points
- Privacy Policy: +5 points
- Terms of Service: +5 points
- Content Scan: +15 points
- Reputation Score: +15 points
- Manual Review: +10 points
- Domain Age: +10 points
- Webhook Setup: +2 points
- API Integration: +3 points

## Network Integration

This API integrates with:

- trace.platphormnews.com - Telemetry and monitoring
- mcp.platphormnews.com - LLM tool access and MCP services
- onboard.platphormnews.com - Onboarding flow

## Rate Limits

Default rate limits vary by trust level:
- Level 0-1: 100 requests/minute
- Level 2: 500 requests/minute
- Level 3-4: 1000 requests/minute

## Webhooks

Subscribe to events:
- registration.created
- registration.verified
- registration.activated
- trust.assessed
- trust.level_changed

Webhooks are signed with HMAC-SHA256 using your webhook secret.

## Example: Create Registration

```bash
curl -X POST https://register.platphormnews.com/api/v1/registrations \
  -H "Content-Type: application/json" \
  -d '{
    "site_name": "My News Site",
    "site_domain": "mynewssite.com",
    "contact_email": "admin@mynewssite.com"
  }'
```

## Links

- [Full API Documentation](/api/docs)
- [Registration Form](/)
- [Trust Level Details](/trust)
- [RSS Feed](/rss.xml)
- [Sitemap](/sitemap.xml)

## Contact

Support: support@platphormnews.com
Network: https://platphormnews.com