Developer Documentation

Kintify Analyze API

Integrate Kintify cloud diagnostics into your own systems. Send a system issue, get a structured diagnosis with confidence scoring, impact levels, and actionable fixes.

Endpoint

POST

https://kintify.cloud/api/analyze

Accepts JSON body with a system issue description. Returns a structured analysis.

Authentication

Include your API key in the x-api-key header.

x-api-key: demo-key

Use demo-key for testing. Rate limited to 60 requests/minute.

Rate Limits

Demo tier

60 req/min

Exceeding the limit returns 429 Too Many Requests with a Retry-After header.

Request

Request body

JSON

{
  "input": "my api is slow and costs are high"
}

Parameters

input

string, required — The system issue, error message, or symptom to analyze. Minimum 3 characters.

Response

Success (200)

JSON

{
  "category": "performance",
  "problem": "Performance degradation detected",
  "cause": "High latency due to inefficient request handling",
  "explanation": "This usually happens when requests are processed sequentially...",
  "fix": [
    "Implement caching (Redis or in-memory)",
    "Use parallel API calls instead of sequential",
    "Optimize database queries and add indexes"
  ],
  "prevention": [
    "Monitor latency with structured logging",
    "Set up rate limits and request budgets",
    "Use autoscaling where possible"
  ],
  "confidence": 87,
  "impact": "High",
  "improvement": "+40% faster",
  "slug": "my-api-is-slow-and-costs-are-high"
}

Error Responses

400

Input too short or missing

{ "error": "Input too short. Provide more details." }

401

Invalid or missing API key

{ "error": "Invalid API key." }

429

Rate limit exceeded

{ "error": "Rate limit exceeded. Max 60 requests per minute." }

500

Internal server error

{ "error": "Analysis failed. Try again." }

Code Examples

cURL

bash

curl -X POST https://kintify.cloud/api/analyze \
  -H "Content-Type: application/json" \
  -H "x-api-key: demo-key" \
  -d '{"input":"my api is slow and timing out"}'

JavaScript (fetch)

JavaScript

const response = await fetch("https://kintify.cloud/api/analyze", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "demo-key",
  },
  body: JSON.stringify({
    input: "my api is slow and timing out",
  }),
});

const data = await response.json();
console.log(data.category);   // "performance"
console.log(data.confidence);  // 87
console.log(data.fix);         // ["Implement caching...", ...]

Python (requests)

Python

import requests

response = requests.post(
    "https://kintify.cloud/api/analyze",
    headers={"x-api-key": "demo-key"},
    json={"input": "my api is slow and timing out"},
)

data = response.json()
print(data["category"])    # "performance"
print(data["confidence"])  # 87
print(data["fix"])         # ["Implement caching...", ...]

Ready to try it?

Try the interactive tool

Need higher rate limits or a production key? Contact us at hello@kintify.cloud