Developer Documentation
Everything you need to integrate and use NormaOS in your applications
1. Create an Account
Sign up for a free account at norma-ai.com/register. You'll get 14 days of Professional features to test the platform.
2. Get Your API Key
Navigate to Settings → API Keys in your dashboard to generate an API key. Keep this key secure and never expose it in client-side code.
3. Install the SDK (Optional)
npm install @norma-ai/sdkOr use our REST API directly with any HTTP client.
4. Make Your First Request
// Upload a document for analysis
const formData = new FormData();
formData.append('document', file);
formData.append('jurisdiction', 'EU');
const response = await fetch('https://api.norma-ai.com/v1/documents', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
},
body: formData
});
const result = await response.json();
console.log('Document ID:', result.documentId);Supported Formats
File Limits
- Maximum file size: 50MB
- Maximum pages: 500
- Minimum text content: 100 characters
Upload Methods
Direct Upload
Upload files directly through the web interface or API
URL Import
Provide a URL to import documents from cloud storage
Base64 Encoding
Send document content as base64 encoded string
Structure Extraction
Parse document structure, identify sections, clauses, and metadata
Key Terms Identification
Extract important terms, definitions, and obligations
Risk Assessment
Identify potential legal risks and compliance issues
Compliance Verification
Check against relevant regulations and standards
Citation Validation
Verify legal references and cited regulations
Report Generation
Compile comprehensive analysis report with recommendations
Analysis Code Example
// Start document analysis
const response = await fetch('https://api.norma-ai.com/v1/analyze', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
documentId: 'doc_123456',
phases: ['structure', 'compliance', 'risk'],
jurisdiction: 'EU'
})
});
const analysis = await response.json();
console.log('Analysis:', analysis);Available Events
Webhook Configuration
// Configure webhook endpoint
const webhook = {
url: 'https://your-app.com/webhooks/norma',
events: ['document.analyzed', 'document.updated'],
secret: 'your_webhook_secret'
};
await fetch('https://api.norma-ai.com/v1/webhooks', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify(webhook)
});Zapier
Automate workflows with 5000+ apps
Slack
Get notifications in your channels
Microsoft Teams
Collaborate on document reviews
Google Drive
Import documents directly
Salesforce
Sync with your CRM
SharePoint
Enterprise document management