API Reference

This section provides comprehensive documentation for the FussyData API endpoints and how to use them with n8n.

Core Endpoints

Get Latest JSON Data

Endpoint: GET /api/v1/submission_request/{request_id}/get_latest_json

Parameters:

• request_id - The unique identifier for your submission request
• token_uuid - Your authentication token

Example URL:

https://app.fussydata.com/api/v1/submission_request/420835c6-a0e1-42c8-bfba-cbba36c96018/get_latest_json?token_uuid=da116df0-f5ec-4c37-b762-3d9eb58a0cf2

Response Format

The API returns JSON data in the following structure:

{
  "data": [
    {
      "column1": "value1",
      "column2": "value2",
      "column3": 123
    }
  ],
  "metadata": {
    "total_rows": 100,
    "columns": ["column1", "column2", "column3"],
    "last_updated": "2024-01-01T12:00:00Z"
  }
}

Authentication

FussyData uses token-based authentication. You’ll need to:

1. Log into your FussyData account
2. Navigate to your submission request
3. Copy the token_uuid from the URL or settings
4. Include it as a query parameter in your API calls

Error Handling

Common HTTP Status Codes

• 200 OK - Request successful
• 401 Unauthorized - Invalid or missing token
• 404 Not Found - Request ID not found
• 429 Too Many Requests - Rate limit exceeded

Error Response Format

{
  "error": "Error message",
  "code": "ERROR_CODE",
  "details": {}
}

Rate Limits

• Free Tier: 100 requests per hour
• Pro Tier: 1000 requests per hour
• Enterprise: Custom limits

Best Practices

1. Cache Responses - Store data locally when possible
2. Handle Errors - Always check for error responses
3. Use HTTPS - All API calls should use HTTPS
4. Monitor Usage - Track your API usage to stay within limits