Circle & Ellipse Calculator - IOTools.cloud

curl --request POST \
  --url https://api.iotools.cloud/v1/tool/circle-ellipse-calculator \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "shape": "circle",
  "unit": "cm",
  "precision": "2",
  "circleSolveFrom": "radius",
  "radius": "5",
  "sectorAngle": "90"
}
'

{
  "tool": "circle-ellipse-calculator",
  "tool_version": "1.0.1",
  "outputs": {
    "results": [
      {
        "property": "Radius",
        "value": "5 cm"
      },
      {
        "property": "Diameter",
        "value": "10 cm"
      },
      {
        "property": "Circumference",
        "value": "31.42 cm"
      },
      {
        "property": "Area",
        "value": "78.54 cm²"
      }
    ],
    "sectorResults": [
      {
        "property": "Arc Length",
        "value": "7.85 cm"
      },
      {
        "property": "Sector Area",
        "value": "19.63 cm²"
      }
    ]
  },
  "credits_used": 3,
  "credits_remaining": null
}

POST

/

v1

/

tool

/

circle-ellipse-calculator

curl --request POST \
  --url https://api.iotools.cloud/v1/tool/circle-ellipse-calculator \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "shape": "circle",
  "unit": "cm",
  "precision": "2",
  "circleSolveFrom": "radius",
  "radius": "5",
  "sectorAngle": "90"
}
'

{
  "tool": "circle-ellipse-calculator",
  "tool_version": "1.0.1",
  "outputs": {
    "results": [
      {
        "property": "Radius",
        "value": "5 cm"
      },
      {
        "property": "Diameter",
        "value": "10 cm"
      },
      {
        "property": "Circumference",
        "value": "31.42 cm"
      },
      {
        "property": "Area",
        "value": "78.54 cm²"
      }
    ],
    "sectorResults": [
      {
        "property": "Arc Length",
        "value": "7.85 cm"
      },
      {
        "property": "Sector Area",
        "value": "19.63 cm²"
      }
    ]
  },
  "credits_used": 3,
  "credits_remaining": null
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

shape

enum<string>

Shape

Available options:

circle,

ellipse

unit

enum<string>

Unit

Available options:

mm,

cm,

m,

in,

ft,

yd

precision

enum<string>

Decimal precision

Available options:

0,

1,

2,

3,

4,

5,

6,

8,

10

circleSolveFrom

enum<string>

Solve circle from

Available options:

radius,

diameter,

circumference,

area

radius

number

Radius

Required range: x >= 0

diameter

number

Diameter

Required range: x >= 0

circumference

number

Circumference

Required range: x >= 0

areaInput

number

Area

Required range: x >= 0

sectorAngle

number

Sector angle (°)

Required range: 0 <= x <= 360

semiMajor

number

Semi-major axis (a)

Required range: x >= 0

semiMinor

number

Semi-minor axis (b)

Required range: x >= 0

Response

Tool output

outputs

object

required

Show child attributes

tool

string

required

The tool's slug, echoing the {slug} in the request path.

tool_version

string

required

Output-contract version for this tool.

credits_used

integer

required

Credits this call consumed, after any settlement refund. 0 when metering is disabled.

credits_remaining

integer | null

required

Credits left in the current monthly allowance, or null when metering is disabled.

request_id

string

Correlation id, also sent as x-request-id.