Skip to content

aunyks/newton-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

newton

A really micro micro-service for advanced math.

Newton does anything from numerical calculation to symbolic math parsing.

How does it work?

  1. Send a GET request to newton with a url-encoded math expression and your preferred operation.
  2. Get back a JSON response with your problem solved.

Show me

Let's find the derivative of x^2. So, we send a request to the newton url saying just that:

-> https://newton.now.sh/api/v2/derive/x%5E2 (Note the url-encoded ^)

Now, we get the following response:

{
  "operation":"derive",
  "expression":"x^2",
  "result":"2 x"
}

It's that simple!

Get Started

  1. Send a GET request to newton.
https://newton.now.sh/api/v2/:operation/:expression

Note: :operation is the math operation that you want to perform. :expression is the url-encoded math expression on which you want to operate. View available operation endpoints below!

  1. That's it! You'll be returned a JSON object with the operation you requested, the expression you provided, and the result of the operation performed on the expression.

View available endpoints:

Operation API Endpoint Result
Simplify /simplify/2^2+2(2) 8
Factor /factor/x^2 + 2x x (x + 2)
Derive /derive/x^2+2x 2 x + 2
Integrate /integrate/x^2+2x 1/3 x^3 + x^2 + C
Find 0's /zeroes/x^2+2x [-2, 0]
Find Tangent /tangent/2lx^3 12 x + -16
Area Under Curve /area/2:4lx^3 60
Cosine /cos/pi -1
Sine /sin/0 0
Tangent /tan/0 0
Inverse Cosine /arccos/1 0
Inverse Sine /arcsin/0 0
Inverse Tangent /arctan/0 0
Absolute Value /abs/-1 1
Logarithm /log/2l8 3

Keep in mind: To find the tangent line of a function at a certain x value, send the request as c|f(x) where c is the given x value and f(x) is the function expression, the separator is a vertical bar '|'. See the table above for an example request.

To find the area under a function, send the request as c:d|f(x) where c is the starting x value, d is the ending x value, and f(x) is the function under which you want the curve between the two x values.

To compute fractions, enter expressions as numerator(over)denominator. For example, to process 2/4 you must send in your expression as 2(over)4. The result expression will be in standard math notation (1/2, 3/4).

What have people made?

Some cool apps and libraries made with Newton include the following:


Built using metadelta.

Want to support Newton development?

Shop MEZCLA!

Licensed under the GNU GPLv3 license.

Copyright (C) 2016-2020  Gerald Nash

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.