Integration & API Guide

// Example authentication header
curl -X GET https://api.ademero.com/v2/documents \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \-H "Content-Type: application/json"

// Document operations
GET    /documents              // List documents
POST   /documents              // Upload document
GET    /documents/{id}         // Get document details
PUT    /documents/{id}         // Update document
DELETE /documents/{id}         // Delete document

// Folder operations
GET    /folders                // List folders
POST   /folders                // Create folder
GET    /folders/{id}/contents  // List folder contents

// Workflow operations
GET    /workflows              // List workflows
POST   /workflows/{id}/start   // Start workflow
GET    /tasks                  // Get user tasks
POST   /tasks/{id}/complete    // Complete task

// User management
GET    /users                  // List users
POST   /users                  // Create user
GET    /users/{id}             // Get user details
PUT    /users/{id}/permissions // Update permissions

// Node.js example
const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('invoice.pdf'));
form.append('metadata', JSON.stringify({
  documentType: 'Invoice',
  vendor: 'Acme Corp',
  amount: 1500.00,
  dueDate: '2024-02-15'
}));

const response = await axios.post(
  'https://api.ademero.com/v2/documents',
  form,
  {
    headers: {
      ...form.getHeaders(),
      'Authorization': 'Bearer YOUR_TOKEN'
    }
  }
);

// Python example
import requests

params = {
  'query': 'invoice',
  'documentType': 'Invoice',
  'dateFrom': '2024-01-01',
  'dateTo': '2024-01-31',
  'vendor': 'Acme Corp'
}

response = requests.get(
  'https://api.ademero.com/v2/documents/search',
  params=params,
  headers={'Authorization': 'Bearer YOUR_TOKEN'}
)

documents = response.json()['results']

// C# example
using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Authorization = 
        new AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");var workflowData = new
    {
        documentId = "DOC-12345",workflowId = "invoice-approval",parameters = new
        {
            urgency = "high",approver = "john.doe@company.com"}
    };
    
    var response = await client.PostAsJsonAsync(
        "https://api.ademero.com/v2/workflows/start",workflowData
    );
}

// Webhook payload example
{
  "event": "document.created","timestamp": "2024-01-15T10:30:45Z","data": {"documentId": "DOC-12345","name": "Invoice_2024_001.pdf","folderId": "FOLDER-789","uploadedBy": "john.doe@company.com","metadata": {"documentType": "Invoice","amount": 1500.00
    }
  }
}

// Installation examples
// Node.js
npm install @ademero/sdk

// Python
pip install ademero-sdk

// Java
<dependency>
  <groupId>com.ademero</groupId>
  <artifactId>ademero-sdk</artifactId>
  <version>2.5.0</version>
</dependency>

// .NET
dotnet add package Ademero.SDK

// JavaScript SDK example
const Ademero = require('@ademero/sdk');

const client = new Ademero({
  apiKey: 'YOUR_API_KEY',
  baseUrl: 'https://api.ademero.com/v2'
});

// Upload document
const document = await client.documents.upload({
  file: fileBuffer,
  folder: '/Finance/Invoices',
  metadata: {
    type: 'Invoice',
    vendor: 'Acme Corp'
  }
});

// Search documents
const results = await client.documents.search({
  query: 'quarterly report',
  filters: {
    dateRange: ['2024-01-01', '2024-03-31']
  }
});