API Reference

This section will contain detailed information about all available Notioc MCP API endpoints, including request parameters, response structures, and usage examples.

Endpoints will cover functionalities such as:

• Listing courses and course content (files, modules)
• Fetching and parsing specific file content
• Searching within documents
• Performing web searches

Example Usage (Conceptual)

Below are conceptual examples of how you might interact with the Notioc MCP API once it's available. (Note: Endpoints, parameters, and response structures are subject to change).

Fetching File Content

Example: Get the processed content for a specific Canvas file ID.

Python (using requests)

import requests

NOTIOC_API_KEY = "YOUR_NOTIOC_API_KEY"
NOTIOC_API_BASE = "https://api.notioc.ai" # Hypothetical Base URL
FILE_ID = "canvas_file_id_12345"

headers = {
    "Authorization": f"Bearer {NOTIOC_API_KEY}"
}

response = requests.get(
    f"{NOTIOC_API_BASE}/api/mcp/v1/files/{FILE_ID}/content", 
    headers=headers
)

if response.status_code == 200:
    file_content = response.json() # Assuming JSON response with content
    print(file_content)
else:
    print(f"Error: {response.status_code} - {response.text}")

TypeScript / JavaScript (using Fetch API)

const NOTIOC_API_KEY = "YOUR_NOTIOC_API_KEY";
const NOTIOC_API_BASE = "https://api.notioc.ai"; // Hypothetical Base URL
const FILE_ID = "canvas_file_id_12345";

async function getNotiocFileContent(fileId: string): Promise<any> {
  const headers = new Headers({
    "Authorization": `Bearer ${NOTIOC_API_KEY}`
  });

  const response = await fetch(
    `${NOTIOC_API_BASE}/api/mcp/v1/files/${fileId}/content`,
    { 
      method: 'GET',
      headers: headers 
    }
  );

  if (!response.ok) {
    const errorText = await response.text();
    throw new Error(`Notioc API Error: ${response.status} - ${errorText}`);
  }

  const fileContent = await response.json(); // Assuming JSON response
  return fileContent;
}

// Example usage:
try {
  const content = await getNotiocFileContent(FILE_ID);
  console.log(content);
} catch (error) {
  console.error(error);
}

The API reference is currently under construction as the MCP API is being developed. More detailed examples and endpoint documentation will be available here soon.