It’s very simple to use: you only need to submit your
api_key and an image via url or POST to the API, and the API will respond as assessment of its validity, as well as additional details like the carrier details, line type, region and city details, and more.
There are two methods to begin working with an image
Upload via URL
Upload an image giving the API an URL with a hosted version of your image.
Upload via POST
Upload an image submitting it directly to the API.
The Image Processing API, like all of Abstract’s APIs, is organized around REST. It is designed to use predictable, resource-oriented URL’s and to use HTTP status codes to indicate errors.
The Image Processing API requires all communications to be secured TLS 1.2 or greater.
All of Abstract’s API are versioned. The Image Processing API is currently on Version 1.
Your API Key
Your API key is your unique authentication key to be used to access Abstract’s Image Processing API. Note that each of Abstract’s API has a unique API key, so you will need different keys to access the Image Processing and Email Validation APIs, for example. To authenticate your requests, you will need to append your API key to the base URL.
Response and error codes
Whenever you make a request that fails for some reason, an error is returned also in the JSON format. The errors include an error code and description, which you can find in detail below.
|Everything worked as expected.
|The request was unacceptable. Typically due to the API key missing or incorrect.
|The request was aborted due to insufficient API credits. (Free plans)
|Too many requests
|The request was aborted due to the number of allowed requests per second being reached. This happens on free plans as requests are limited to 1 per second.
|Internal server error
|The request could not be completed due to an error on the server side.
|The server was unavailable.