School API Documentation

// Step 1: Initialize API client
const API_KEY = 'sk_school_yourschool_abc123...';
const BASE_URL = 'https://www.talents.kids/api/school/v1';

// Step 2: Analyze student work
async function analyzeStudentWork(studentId, age, filePath) {
  // Read and encode file
  const fs = require('fs');
  const content = fs.readFileSync(filePath);
  const base64 = content.toString('base64');

  // Submit analysis
  const response = await fetch(`${BASE_URL}/analyze`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      student_id: studentId,
      student_age: age,
      document_type: 'plain_text_files', // Auto-selects best AI preset
      media: [{
        file: base64,
        filename: 'essay.txt',
        mime_type: 'text/plain'
      }]
    })
  });

  const result = await response.json();
  console.log(`Analysis started: ${result.id}`);
  return result.id;
}

// Step 3: Get results when ready
async function getResults(analysisId) {
  const response = await fetch(`${BASE_URL}/analyses/${analysisId}/result`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    }
  });

  const results = await response.json();
  console.log('Top talents:', results.analysis_result.keyTalents);
  return results;
}

// Example usage
analyzeStudentWork('student_001', 12, 'student_essay.txt')
  .then(id => setTimeout(() => getResults(id), 90000)); // Check after 90 seconds