API

Base URL: https://spincrus.uz/api. All endpoints accept and return JSON. Send your key in the x-api-key header. Without a key you get 100 calls per day per tool from one IP address.

Authentication & limits

Every response carries x-ratelimit-limit and x-ratelimit-remaining. Over the limit → HTTP 429 with an upgrade link.

Endpoints

GET /v1/tools — list tools with their input schema.

curl -X POST https://spincrus.uz/api/v1/tools/cron-expression-explainer -H "content-type: application/json" -d '{"expression":"0 9 * * 1-5"}'

{
  "ok": true,
  "result": {
    "expression": "0 9 * * 1-5",
    "description": "At 09:00 on Monday through Friday.",
    "fields": {
      "minute": "0",
      "hour": "9",
      "dayOfMonth": "*",
      "month": "*",
      "dayOfWeek": "1-5"
    }
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/readability-checker -H "content-type: application/json" -d '{"text":"The quick brown fox jumps over the lazy dog. It was a sunny day and everyone was happy."}'

{
  "ok": true,
  "result": {
    "words": 18,
    "sentences": 2,
    "syllables": 24,
    "characters": 68,
    "complexWords": 1,
    "avgWordsPerSentence": 9,
    "readingTimeSec": 5,
    "fleschReadingEase": 84.9,
    "fleschKincaidGrade": 3.7,
    "gunningFog": 5.8,
    "automatedReadabilityIndex": 0.9,
    "level": "Easy (6th grade)"
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/json-to-csv -H "content-type: application/json" -d '{"json":"[{\"id\":1,\"user\":{\"name\":\"Ada\"}},{\"id\":2,\"user\":{\"name\":\"Linus\"}}]"}'

{
  "ok": true,
  "result": {
    "csv": "id,user.name\n1,Ada\n2,Linus",
    "rows": 2,
    "columns": [
      "id",
      "user.name"
    ]
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/timestamp-converter -H "content-type: application/json" -d '{"value":"1700000000","unit":"auto"}'

{
  "ok": true,
  "result": {
    "unixSeconds": 1700000000,
    "unixMilliseconds": 1700000000000,
    "iso": "2023-11-14T22:13:20.000Z",
    "utc": "Tue, 14 Nov 2023 22:13:20 GMT",
    "relative": "2 years ago"
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/jwt-decoder -H "content-type: application/json" -d '{"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"}'

{
  "ok": true,
  "result": {
    "header": {
      "alg": "HS256",
      "typ": "JWT"
    },
    "payload": {
      "sub": "1234567890",
      "name": "John Doe",
      "iat": 1516239022
    },
    "signature": "SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
    "algorithm": "HS256",
    "issuedAt": "2018-01-18T01:30:22.000Z",
    "expiresAt": null,
    "notBefore": null,
    "isExpired": null
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/slug-generator -H "content-type: application/json" -d '{"text":"Café Économique — 10 Tips for Beginners!","separator":"-","lowercase":true}'

{
  "ok": true,
  "result": {
    "slug": "cafe-economique-10-tips-for-beginners",
    "length": 37
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/base64 -H "content-type: application/json" -d '{"text":"Hello, мир! 👋","mode":"encode","urlSafe":false}'

{
  "ok": true,
  "result": {
    "mode": "encode",
    "output": "SGVsbG8sINC80LjRgCEg8J+Riw==",
    "inputBytes": 19,
    "outputBytes": 28
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/url-encode-decode -H "content-type: application/json" -d '{"text":"https://example.com/search?q=café & crème","mode":"encode","scope":"full","plusAsSpace":false}'

{
  "ok": true,
  "result": {
    "mode": "encode",
    "scope": "full",
    "output": "https://example.com/search?q=caf%C3%A9%20&%20cr%C3%A8me",
    "inputLength": 41,
    "outputLength": 55
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/json-formatter -H "content-type: application/json" -d '{"text":"{\"name\":\"Ada\",\"tags\":[\"math\",\"code\"],\"born\":1815,\"address\":{\"city\":\"London\"}}","mode":"format","indent":2,"sortKeys":false}'

{
  "ok": true,
  "result": {
    "mode": "format",
    "valid": true,
    "output": "{\n  \"name\": \"Ada\",\n  \"tags\": [\n    \"math\",\n    \"code\"\n  ],\n  \"born\": 1815,\n  \"address\": {\n    \"city\": \"London\"\n  }\n}",
    "type": "object",
    "keys": 5,
    "depth": 2,
    "inputLength": 77,
    "outputLength": 116
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/case-converter -H "content-type: application/json" -d '{"text":"The quick brown fox","style":"snake"}'

{
  "ok": true,
  "result": {
    "style": "snake",
    "output": "the_quick_brown_fox",
    "inputLength": 19,
    "outputLength": 19
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/word-counter -H "content-type: application/json" -d '{"text":"The quick brown fox jumps over the lazy dog. It was well-known that the dog never minded!"}'

{
  "ok": true,
  "result": {
    "words": 17,
    "characters": 89,
    "charactersNoSpaces": 73,
    "sentences": 2,
    "paragraphs": 1,
    "lines": 1,
    "uniqueWords": 14,
    "averageWordLength": 4.1,
    "readingTimeMinutes": 0.1,
    "speakingTimeMinutes": 0.1,
    "topWords": [
      {
        "word": "the",
        "count": 3
      },
      {
        "word": "dog",
        "count": 2
      },
      {
        "word": "brown",
        "count": 1
      },
      {
        "word": "fox",
        "count": 1
      },
      {
        "word": "it",
        "count": 1
      }
    ]
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/remove-duplicate-lines -H "content-type: application/json" -d '{"text":"apple\nbanana\nApple\napple\n\ncherry\nbanana","caseSensitive":false,"removeEmpty":true}'

{
  "ok": true,
  "result": {
    "text": "apple\nbanana\ncherry",
    "originalLines": 7,
    "uniqueLines": 3,
    "removedLines": 4
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/lorem-ipsum-generator -H "content-type: application/json" -d '{"count":2,"unit":"paragraphs","startWithLorem":true}'

{
  "ok": true,
  "result": {
    "text": "Lorem ipsum dolor sit amet consectetur adipiscing elit. Elit amet ad proident deserunt proident ad aute. Amet cillum elit ex nulla velit ullamco eiusmod.\n\nVoluptate lorem incididunt occaecat culpa anim minim do. Ipsum nostrud aliqua id lorem, excepteur cillum id voluptate velit qui. Cillum pariatur nulla esse non esse in voluptate sint et sunt, sit ad mollit ad. Do incididunt quis elit fugiat anim qui amet deserunt velit excepteur, nostrud eu sed excepteur. Dolore qui dolore eiusmod voluptate nostrud.",
    "unit": "paragraphs",
    "count": 2,
    "words": 79,
    "characters": 506
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/color-converter -H "content-type: application/json" -d '{"color":"#1e90ff"}'

{
  "ok": true,
  "result": {
    "hex": "#1e90ff",
    "rgb": "rgb(30, 144, 255)",
    "hsl": "hsl(210, 100%, 56%)",
    "r": 30,
    "g": 144,
    "b": 255,
    "h": 210,
    "s": 100,
    "l": 56
  }
}

curl -X POST https://spincrus.uz/api/v1/tools/number-base-converter -H "content-type: application/json" -d '{"value":"11111111","fromBase":2}'

{
  "ok": true,
  "result": {
    "binary": "11111111",
    "octal": "377",
    "decimal": "255",
    "hex": "ff",
    "custom": "73",
    "customBase": 36
  }
}

Errors

400 invalid input (message in error), 401 bad key, 404 unknown tool, 429 limit reached, 500 our fault — retry.