{
  "name": "File Hosting API for n8n",
  "version": "1.0.0",
  "baseUrl": "https://apprentice.cyou",
  "language": "id-ID",
  "description": "Dokumentasi machine-readable untuk API upload, streaming, dan integrasi n8n.",
  "authentication": {
    "type": "header",
    "header": "x-api-key",
    "requiredFor": [
      "/api/files",
      "/api/files/:id"
    ]
  },
  "publicEndpoints": [
    {
      "method": "GET",
      "path": "/health",
      "description": "Cek status server."
    },
    {
      "method": "POST",
      "path": "/upload",
      "description": "Upload file publik multipart/form-data.",
      "body": {
        "file": "binary"
      }
    },
    {
      "method": "GET",
      "path": "/files/:filename",
      "description": "Streaming atau download file."
    },
    {
      "method": "GET",
      "path": "/api/capabilities",
      "description": "Kemampuan runtime server."
    }
  ],
  "apiEndpoints": [
    {
      "method": "POST",
      "path": "/api/files",
      "description": "Upload via n8n/API key.",
      "body": {
        "file": "binary",
        "expiry_minutes": "number|string",
        "meta": "stringified JSON"
      }
    },
    {
      "method": "GET",
      "path": "/api/files?status=active|expired",
      "description": "List file."
    },
    {
      "method": "GET",
      "path": "/api/files/:id",
      "description": "Detail file."
    },
    {
      "method": "PATCH",
      "path": "/api/files/:id",
      "description": "Update expiry atau metadata."
    },
    {
      "method": "DELETE",
      "path": "/api/files/:id",
      "description": "Hapus file."
    }
  ],
  "n8n": {
    "httpRequestNodeTypeVersion": "4.2",
    "uploadContentType": "multipart-form-data",
    "uploadBinaryFieldName": "file",
    "binaryInputFieldName": "data",
    "recommendedEnv": [
      "FILE_HOSTING_BASE_URL",
      "FILE_HOSTING_API_KEY",
      "WEBHOOK_URL",
      "N8N_PROXY_HOPS"
    ]
  },
  "resources": {
    "home": "/",
    "llms": "/llms.txt",
    "sitemap": "/sitemap.xml",
    "robots": "/robots.txt"
  }
}