Software Developer Guide

Authentication

Sheetflow uses API key authentication. Include your key in requests:

curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     https://sheetflow.cloud/api/calculations/{calculation-id}

Making API Calls

Endpoint Pattern: GET /calculations/{calculation-id} (for queries with parameters)

Request Format (as query parameters):

GET /calculations/{calculation-id}?income=75000&tax_rate=0.22&standard_deduction=12950

Response Format:

{
  "success": true,
  "data": {
    "income": 75000,
    "tax_rate": 0.22,
    "standard_deduction": 12950,
    "taxable_income": 62050,
    "tax_owed": 13651
  }
}

Integration Examples

JavaScript/Node.js

const params = new URLSearchParams({
  income: 75000,
  tax_rate: 0.22,
  standard_deduction: 12950
});

const response = await fetch(`https://sheetflow.cloud/api/calculations/your-calculation-id?${params}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});

const result = await response.json();
console.log(`Tax owed: ${result.data.tax_owed}`);

Python

import requests

response = requests.get(
    'https://sheetflow.cloud/api/calculations/your-calculation-id',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
    params={
        'income': 75000,
        'tax_rate': 0.22,
        'standard_deduction': 12950
    }
)

result = response.json()
print(f"Tax owed: ${result['data']['tax_owed']}")

cURL

curl "https://sheetflow.cloud/api/calculations/your-calculation-id?income=75000&tax_rate=0.22&standard_deduction=12950" \
  -H "Authorization: Bearer YOUR_TOKEN"

Error Handling

Standard HTTP Status Codes:

• 200: Success
• 400: Bad Request (invalid input)
• 401: Unauthorized (invalid API key)
• 404: Sheet not found
• 422: Validation error
• 500: Server error

Error Response Format:

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input: income must be a positive number",
    "details": {
      "field": "income",
      "provided": -1000
    }
  }
}

Rate Limits

• Developer Plan: 10,000 requests/month
• Business Plan: 100,000 requests/month
• Enterprise Plan: 1,000,000 requests/month
• Financial: Same as Enterprise

Rate limit headers included in responses:

X-Requests-Left: 999

Ready to get started? Sign up now and convert your first Excel model to an API in minutes!