{
  "info": {
    "name": "PlatPhorm Podcasts API",
    "description": "Public read-only and authenticated operator examples for the PlatPhorm Podcasts API. Set apiKey only in a local Postman environment; this collection contains no secret.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://podcasts.platphormnews.com" },
    { "key": "apiKey", "value": "" },
    { "key": "sourceUrl", "value": "https://example.com/feed.xml" }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "x-platphorm-api-key", "type": "string" },
      { "key": "value", "value": "{{apiKey}}", "type": "string" },
      { "key": "in", "value": "header", "type": "string" }
    ]
  },
  "item": [
    {
      "name": "Public discovery",
      "item": [
        { "name": "Health", "request": { "method": "GET", "url": "{{baseUrl}}/api/health" } },
        { "name": "Search", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/search?q=live&limit=24" } },
        { "name": "Recent activity", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/activity/recent?limit=12" } },
        { "name": "Library", "request": { "method": "GET", "url": "{{baseUrl}}/api/v1/library?limit=24&offset=0" } },
        { "name": "RSS", "request": { "method": "GET", "url": "{{baseUrl}}/rss.xml" } },
        { "name": "Atom", "request": { "method": "GET", "url": "{{baseUrl}}/atom.xml" } },
        { "name": "JSON Feed", "request": { "method": "GET", "url": "{{baseUrl}}/feed.json" } },
        { "name": "OpenAPI", "request": { "method": "GET", "url": "{{baseUrl}}/openapi.json" } },
        { "name": "MCP metadata", "request": { "method": "GET", "url": "{{baseUrl}}/api/mcp" } }
      ]
    },
    {
      "name": "Authenticated actions",
      "item": [
        {
          "name": "Follow source",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"sourceUrl\": \"{{sourceUrl}}\",\n  \"title\": \"Example public source\",\n  \"provider\": \"Postman\"\n}" },
            "url": "{{baseUrl}}/api/v1/source-follows"
          }
        },
        {
          "name": "Record useful vote",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"targetType\": \"source\",\n  \"targetId\": \"example-source\",\n  \"action\": \"useful\"\n}" },
            "url": "{{baseUrl}}/api/v1/community/actions"
          }
        },
        {
          "name": "Queue remediation",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"actionId\": \"example-action\",\n  \"targetType\": \"source\",\n  \"targetId\": \"example-source\",\n  \"action\": \"broken\"\n}" },
            "url": "{{baseUrl}}/api/v1/community/remediation"
          }
        }
      ]
    }
  ]
}