AMERICAFIRST.WATCH Debate Publishing API Guide

External Debate Publishing API

Use an API key generated from the admin console to create or update debate threads directly on americafirst.watch.

Base URL

https://aws.americafirst.watch

Authentication

Authorization: Bearer {API_KEY}

Admin-managed intro

이 API는 americafirst.watch 토론 게시판에 외부 글을 등록하거나 수정하는 전용 API입니다. 참고용 레퍼런스 미러 설정과는 별개로, 아래 API 키와 게시판 권한만 사용하면 됩니다.

Endpoints

GET /api/partner/v1/health
GET /api/partner/v1/me
GET /api/partner/v1/posts?status=all&limit=20
POST /api/partner/v1/posts/upsert

Rules

externalId must be unique per API key.
Posting the same externalId again updates the existing post.
teamId is optional. When provided, it is mapped into the local debate stance badge.
Send imageUrl for a hosted image or imageData for a data:image/* base64 upload.
Legacy clients may safely read result.postUrl. The same URL is also returned as postUrl, post.postUrl, and data.postUrl.

Board / Category IDs

policy_talk: policy_reform, presidential_legacy, election_democracy, economy_taxation, war_foreign_policy, constitutional_supreme_court, civil_rights_social_justice, immigration, healthcare, media_misinformation, energy_environment
free_square: open_forum, general

Team IDs

conservative
progressive

Sample Payload

{
  "externalId": "afw-policy_talk-sample-001",
  "boardId": "policy_talk",
  "categoryId": "policy_reform",
  "title": "AFW 게시판 등록 샘플 제목",
  "content": "americafirst.watch 토론 게시판 등록 예시입니다. 같은 externalId로 다시 보내면 수정 처리됩니다.",
  "authorNickname": "AFW Syndication Desk",
  "imageUrl": "https://example.com/sample.jpg"
}

Sample Upsert Response

{
  "ok": true,
  "operation": "created",
  "postUrl": "https://aws.americafirst.watch/discussion.html?topic=123",
  "result": {
    "postUrl": "https://aws.americafirst.watch/discussion.html?topic=123",
    "discussionId": 123,
    "externalId": "partner-post-001"
  },
  "post": {
    "postUrl": "https://aws.americafirst.watch/discussion.html?topic=123",
    "discussionId": 123
  },
  "data": {
    "postUrl": "https://aws.americafirst.watch/discussion.html?topic=123",
    "discussionId": 123
  }
}