Numbers API

GetDateFact

monthDayDateGet

Get a fact about a day of year


/{month}/{day}/date

Usage and SDK Samples

curl -X GET -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/numbers/{month}/{day}/date?fragment=&json="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GetDateFactApi;

import java.io.File;
import java.util.*;

public class GetDateFactApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        GetDateFactApi apiInstance = new GetDateFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        BigDecimal month = 8.14; // BigDecimal | The 1-indexed month (eg. 6 for June)
        BigDecimal day = 8.14; // BigDecimal | The day of the month.
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        try {
            date result = apiInstance.monthDayDateGet(apiecoKey, month, day, fragment, json);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetDateFactApi#monthDayDateGet");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GetDateFactApi;

public class GetDateFactApiExample {

    public static void main(String[] args) {
        GetDateFactApi apiInstance = new GetDateFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        BigDecimal month = 8.14; // BigDecimal | The 1-indexed month (eg. 6 for June)
        BigDecimal day = 8.14; // BigDecimal | The day of the month.
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        try {
            date result = apiInstance.monthDayDateGet(apiecoKey, month, day, fragment, json);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetDateFactApi#monthDayDateGet");
            e.printStackTrace();
        }
    }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
BigDecimal *month = 8.14; // The 1-indexed month (eg. 6 for June)
BigDecimal *day = 8.14; // The day of the month.
String *fragment = fragment_example; // Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
String *json = json_example; // Specify "true" to return result as JSON instead of plaintext. (optional)

GetDateFactApi *apiInstance = [[GetDateFactApi alloc] init];

//  Get a fact about a day of year
[apiInstance monthDayDateGetWith:apiecoKey
    month:month
    day:day
    fragment:fragment
    json:json
              completionHandler: ^(date output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var NumbersApi_ = require('numbers_api___');
var defaultClient = NumbersApi_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new NumbersApi_.GetDateFactApi()

var apiecoKey = apiecoKey_example; // {String} 

var month = 8.14; // {BigDecimal} The 1-indexed month (eg. 6 for June)

var day = 8.14; // {BigDecimal} The day of the month.

var opts = { 
  'fragment': fragment_example, // {String} Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
  'json': json_example // {String} Specify "true" to return result as JSON instead of plaintext.
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.monthDayDateGet(apiecoKey, month, day, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class monthDayDateGetExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new GetDateFactApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var month = 8.14;  // BigDecimal | The 1-indexed month (eg. 6 for June)
            var day = 8.14;  // BigDecimal | The day of the month.
            var fragment = fragment_example;  // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional) 
            var json = json_example;  // String | Specify "true" to return result as JSON instead of plaintext. (optional) 

            try
            {
                //  Get a fact about a day of year
                date result = apiInstance.monthDayDateGet(apiecoKey, month, day, fragment, json);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GetDateFactApi.monthDayDateGet: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\GetDateFactApi();
$apiecoKey = apiecoKey_example; // String | 
$month = 8.14; // BigDecimal | The 1-indexed month (eg. 6 for June)
$day = 8.14; // BigDecimal | The day of the month.
$fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
$json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.

try {
    $result = $api_instance->monthDayDateGet($apiecoKey, $month, $day, $fragment, $json);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GetDateFactApi->monthDayDateGet: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GetDateFactApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::GetDateFactApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $month = 8.14; # BigDecimal | The 1-indexed month (eg. 6 for June)
my $day = 8.14; # BigDecimal | The day of the month.
my $fragment = fragment_example; # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
my $json = json_example; # String | Specify "true" to return result as JSON instead of plaintext.

eval { 
    my $result = $api_instance->monthDayDateGet(apiecoKey => $apiecoKey, month => $month, day => $day, fragment => $fragment, json => $json);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GetDateFactApi->monthDayDateGet: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.GetDateFactApi()
apiecoKey = apiecoKey_example # String | 
month = 8.14 # BigDecimal | The 1-indexed month (eg. 6 for June)
day = 8.14 # BigDecimal | The day of the month.
fragment = fragment_example # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
json = json_example # String | Specify "true" to return result as JSON instead of plaintext. (optional)

try: 
    #  Get a fact about a day of year
    api_response = api_instance.month_day_date_get(apiecoKey, month, day, fragment=fragment, json=json)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GetDateFactApi->monthDayDateGet: %s\n" % e)

Parameters

Path parameters
Name Description
month*
BigDecimal
The 1-indexed month (eg. 6 for June)
Required
day*
BigDecimal
The day of the month.
Required
Header parameters
Name Description
apieco-key*
String
Required
Query parameters
Name Description
fragment
String
Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
json
String
Specify "true" to return result as JSON instead of plaintext.

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 405 - Invalid input


GetMathFact

numberMathGet

Get a mathematical property about a number


/{number}/math

Usage and SDK Samples

curl -X GET -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/numbers/{number}/math?fragment=&json="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GetMathFactApi;

import java.io.File;
import java.util.*;

public class GetMathFactApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        GetMathFactApi apiInstance = new GetMathFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        BigDecimal number = 8.14; // BigDecimal | The integer of interest
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        try {
            math result = apiInstance.numberMathGet(apiecoKey, number, fragment, json);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetMathFactApi#numberMathGet");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GetMathFactApi;

public class GetMathFactApiExample {

    public static void main(String[] args) {
        GetMathFactApi apiInstance = new GetMathFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        BigDecimal number = 8.14; // BigDecimal | The integer of interest
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        try {
            math result = apiInstance.numberMathGet(apiecoKey, number, fragment, json);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetMathFactApi#numberMathGet");
            e.printStackTrace();
        }
    }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
BigDecimal *number = 8.14; // The integer of interest
String *fragment = fragment_example; // Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
String *json = json_example; // Specify "true" to return result as JSON instead of plaintext. (optional)

GetMathFactApi *apiInstance = [[GetMathFactApi alloc] init];

//  Get a mathematical property about a number
[apiInstance numberMathGetWith:apiecoKey
    number:number
    fragment:fragment
    json:json
              completionHandler: ^(math output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var NumbersApi_ = require('numbers_api___');
var defaultClient = NumbersApi_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new NumbersApi_.GetMathFactApi()

var apiecoKey = apiecoKey_example; // {String} 

var number = 8.14; // {BigDecimal} The integer of interest

var opts = { 
  'fragment': fragment_example, // {String} Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
  'json': json_example // {String} Specify "true" to return result as JSON instead of plaintext.
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.numberMathGet(apiecoKey, number, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class numberMathGetExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new GetMathFactApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var number = 8.14;  // BigDecimal | The integer of interest
            var fragment = fragment_example;  // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional) 
            var json = json_example;  // String | Specify "true" to return result as JSON instead of plaintext. (optional) 

            try
            {
                //  Get a mathematical property about a number
                math result = apiInstance.numberMathGet(apiecoKey, number, fragment, json);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GetMathFactApi.numberMathGet: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\GetMathFactApi();
$apiecoKey = apiecoKey_example; // String | 
$number = 8.14; // BigDecimal | The integer of interest
$fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
$json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.

try {
    $result = $api_instance->numberMathGet($apiecoKey, $number, $fragment, $json);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GetMathFactApi->numberMathGet: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GetMathFactApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::GetMathFactApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $number = 8.14; # BigDecimal | The integer of interest
my $fragment = fragment_example; # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
my $json = json_example; # String | Specify "true" to return result as JSON instead of plaintext.

eval { 
    my $result = $api_instance->numberMathGet(apiecoKey => $apiecoKey, number => $number, fragment => $fragment, json => $json);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GetMathFactApi->numberMathGet: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.GetMathFactApi()
apiecoKey = apiecoKey_example # String | 
number = 8.14 # BigDecimal | The integer of interest
fragment = fragment_example # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
json = json_example # String | Specify "true" to return result as JSON instead of plaintext. (optional)

try: 
    #  Get a mathematical property about a number
    api_response = api_instance.number_math_get(apiecoKey, number, fragment=fragment, json=json)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GetMathFactApi->numberMathGet: %s\n" % e)

Parameters

Path parameters
Name Description
number*
BigDecimal
The integer of interest
Required
Header parameters
Name Description
apieco-key*
String
Required
Query parameters
Name Description
fragment
String
Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
json
String
Specify "true" to return result as JSON instead of plaintext.

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 405 - Invalid input


GetRadnomFact

randomTypeGet

Get result by random number


/random/{type}

Usage and SDK Samples

curl -X GET -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/numbers/random/{type}?fragment=&json=&max=&min="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GetRadnomFactApi;

import java.io.File;
import java.util.*;

public class GetRadnomFactApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        GetRadnomFactApi apiInstance = new GetRadnomFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        String type = type_example; // String | One of "trivia", "math", "date", or "year"
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        String max = max_example; // String | Maximium number, inclusive
        String min = min_example; // String | Minimum number, inclusive
        try {
            math result = apiInstance.randomTypeGet(apiecoKey, type, fragment, json, max, min);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetRadnomFactApi#randomTypeGet");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GetRadnomFactApi;

public class GetRadnomFactApiExample {

    public static void main(String[] args) {
        GetRadnomFactApi apiInstance = new GetRadnomFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        String type = type_example; // String | One of "trivia", "math", "date", or "year"
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        String max = max_example; // String | Maximium number, inclusive
        String min = min_example; // String | Minimum number, inclusive
        try {
            math result = apiInstance.randomTypeGet(apiecoKey, type, fragment, json, max, min);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetRadnomFactApi#randomTypeGet");
            e.printStackTrace();
        }
    }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
String *type = type_example; // One of "trivia", "math", "date", or "year"
String *fragment = fragment_example; // Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
String *json = json_example; // Specify "true" to return result as JSON instead of plaintext. (optional)
String *max = max_example; // Maximium number, inclusive (optional)
String *min = min_example; // Minimum number, inclusive (optional)

GetRadnomFactApi *apiInstance = [[GetRadnomFactApi alloc] init];

//  Get result by random number
[apiInstance randomTypeGetWith:apiecoKey
    type:type
    fragment:fragment
    json:json
    max:max
    min:min
              completionHandler: ^(math output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var NumbersApi_ = require('numbers_api___');
var defaultClient = NumbersApi_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new NumbersApi_.GetRadnomFactApi()

var apiecoKey = apiecoKey_example; // {String} 

var type = type_example; // {String} One of "trivia", "math", "date", or "year"

var opts = { 
  'fragment': fragment_example, // {String} Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
  'json': json_example, // {String} Specify "true" to return result as JSON instead of plaintext.
  'max': max_example, // {String} Maximium number, inclusive
  'min': min_example // {String} Minimum number, inclusive
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.randomTypeGet(apiecoKey, type, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class randomTypeGetExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new GetRadnomFactApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var type = type_example;  // String | One of "trivia", "math", "date", or "year"
            var fragment = fragment_example;  // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional) 
            var json = json_example;  // String | Specify "true" to return result as JSON instead of plaintext. (optional) 
            var max = max_example;  // String | Maximium number, inclusive (optional) 
            var min = min_example;  // String | Minimum number, inclusive (optional) 

            try
            {
                //  Get result by random number
                math result = apiInstance.randomTypeGet(apiecoKey, type, fragment, json, max, min);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GetRadnomFactApi.randomTypeGet: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\GetRadnomFactApi();
$apiecoKey = apiecoKey_example; // String | 
$type = type_example; // String | One of "trivia", "math", "date", or "year"
$fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
$json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
$max = max_example; // String | Maximium number, inclusive
$min = min_example; // String | Minimum number, inclusive

try {
    $result = $api_instance->randomTypeGet($apiecoKey, $type, $fragment, $json, $max, $min);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GetRadnomFactApi->randomTypeGet: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GetRadnomFactApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::GetRadnomFactApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $type = type_example; # String | One of "trivia", "math", "date", or "year"
my $fragment = fragment_example; # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
my $json = json_example; # String | Specify "true" to return result as JSON instead of plaintext.
my $max = max_example; # String | Maximium number, inclusive
my $min = min_example; # String | Minimum number, inclusive

eval { 
    my $result = $api_instance->randomTypeGet(apiecoKey => $apiecoKey, type => $type, fragment => $fragment, json => $json, max => $max, min => $min);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GetRadnomFactApi->randomTypeGet: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.GetRadnomFactApi()
apiecoKey = apiecoKey_example # String | 
type = type_example # String | One of "trivia", "math", "date", or "year"
fragment = fragment_example # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
json = json_example # String | Specify "true" to return result as JSON instead of plaintext. (optional)
max = max_example # String | Maximium number, inclusive (optional)
min = min_example # String | Minimum number, inclusive (optional)

try: 
    #  Get result by random number
    api_response = api_instance.random_type_get(apiecoKey, type, fragment=fragment, json=json, max=max, min=min)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GetRadnomFactApi->randomTypeGet: %s\n" % e)

Parameters

Path parameters
Name Description
type*
String
One of "trivia", "math", "date", or "year"
Required
Header parameters
Name Description
apieco-key*
String
Required
Query parameters
Name Description
fragment
String
Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
json
String
Specify "true" to return result as JSON instead of plaintext.
max
String
Maximium number, inclusive
min
String
Minimum number, inclusive

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 405 - Invalid input


GetTriviaFact

numberTriviaGet

Get a trivia fact about a number


/{number}/trivia

Usage and SDK Samples

curl -X GET -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/numbers/{number}/trivia?fragment=&json=¬found="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GetTriviaFactApi;

import java.io.File;
import java.util.*;

public class GetTriviaFactApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        GetTriviaFactApi apiInstance = new GetTriviaFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        BigDecimal number = 8.14; // BigDecimal | The integer of interest
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        String notfound = notfound_example; // String | Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact).
        try {
            math result = apiInstance.numberTriviaGet(apiecoKey, number, fragment, json, notfound);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetTriviaFactApi#numberTriviaGet");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GetTriviaFactApi;

public class GetTriviaFactApiExample {

    public static void main(String[] args) {
        GetTriviaFactApi apiInstance = new GetTriviaFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        BigDecimal number = 8.14; // BigDecimal | The integer of interest
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        String notfound = notfound_example; // String | Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact).
        try {
            math result = apiInstance.numberTriviaGet(apiecoKey, number, fragment, json, notfound);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetTriviaFactApi#numberTriviaGet");
            e.printStackTrace();
        }
    }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
BigDecimal *number = 8.14; // The integer of interest
String *fragment = fragment_example; // Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
String *json = json_example; // Specify "true" to return result as JSON instead of plaintext. (optional)
String *notfound = notfound_example; // Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact). (optional)

GetTriviaFactApi *apiInstance = [[GetTriviaFactApi alloc] init];

//  Get a trivia fact about a number
[apiInstance numberTriviaGetWith:apiecoKey
    number:number
    fragment:fragment
    json:json
    notfound:notfound
              completionHandler: ^(math output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var NumbersApi_ = require('numbers_api___');
var defaultClient = NumbersApi_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new NumbersApi_.GetTriviaFactApi()

var apiecoKey = apiecoKey_example; // {String} 

var number = 8.14; // {BigDecimal} The integer of interest

var opts = { 
  'fragment': fragment_example, // {String} Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
  'json': json_example, // {String} Specify "true" to return result as JSON instead of plaintext.
  'notfound': notfound_example // {String} Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact).
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.numberTriviaGet(apiecoKey, number, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class numberTriviaGetExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new GetTriviaFactApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var number = 8.14;  // BigDecimal | The integer of interest
            var fragment = fragment_example;  // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional) 
            var json = json_example;  // String | Specify "true" to return result as JSON instead of plaintext. (optional) 
            var notfound = notfound_example;  // String | Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact). (optional) 

            try
            {
                //  Get a trivia fact about a number
                math result = apiInstance.numberTriviaGet(apiecoKey, number, fragment, json, notfound);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GetTriviaFactApi.numberTriviaGet: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\GetTriviaFactApi();
$apiecoKey = apiecoKey_example; // String | 
$number = 8.14; // BigDecimal | The integer of interest
$fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
$json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
$notfound = notfound_example; // String | Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact).

try {
    $result = $api_instance->numberTriviaGet($apiecoKey, $number, $fragment, $json, $notfound);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GetTriviaFactApi->numberTriviaGet: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GetTriviaFactApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::GetTriviaFactApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $number = 8.14; # BigDecimal | The integer of interest
my $fragment = fragment_example; # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
my $json = json_example; # String | Specify "true" to return result as JSON instead of plaintext.
my $notfound = notfound_example; # String | Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact).

eval { 
    my $result = $api_instance->numberTriviaGet(apiecoKey => $apiecoKey, number => $number, fragment => $fragment, json => $json, notfound => $notfound);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GetTriviaFactApi->numberTriviaGet: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.GetTriviaFactApi()
apiecoKey = apiecoKey_example # String | 
number = 8.14 # BigDecimal | The integer of interest
fragment = fragment_example # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
json = json_example # String | Specify "true" to return result as JSON instead of plaintext. (optional)
notfound = notfound_example # String | Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact). (optional)

try: 
    #  Get a trivia fact about a number
    api_response = api_instance.number_trivia_get(apiecoKey, number, fragment=fragment, json=json, notfound=notfound)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GetTriviaFactApi->numberTriviaGet: %s\n" % e)

Parameters

Path parameters
Name Description
number*
BigDecimal
The integer of interest
Required
Header parameters
Name Description
apieco-key*
String
Required
Query parameters
Name Description
fragment
String
Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
json
String
Specify "true" to return result as JSON instead of plaintext.
notfound
String
Specifies what to return if the number is not found. Value can be "default" (to return a canned message), "floor" (to round down to the largest number that does have an associated fact, and return that fact), or "ceil" (which is like floor but rounds up to the smallest number that has an associated fact).

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 405 - Invalid input


GetYearFact

yearYearGet

Get a fact about a year


/{year}/year

Usage and SDK Samples

curl -X GET -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/numbers/{year}/year?fragment=&json="
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.GetYearFactApi;

import java.io.File;
import java.util.*;

public class GetYearFactApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        GetYearFactApi apiInstance = new GetYearFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        String year = year_example; // String | The year of interest
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        try {
            year result = apiInstance.yearYearGet(apiecoKey, year, fragment, json);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetYearFactApi#yearYearGet");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.GetYearFactApi;

public class GetYearFactApiExample {

    public static void main(String[] args) {
        GetYearFactApi apiInstance = new GetYearFactApi();
        String apiecoKey = apiecoKey_example; // String | 
        String year = year_example; // String | The year of interest
        String fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
        String json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.
        try {
            year result = apiInstance.yearYearGet(apiecoKey, year, fragment, json);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling GetYearFactApi#yearYearGet");
            e.printStackTrace();
        }
    }
}
Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
String *year = year_example; // The year of interest
String *fragment = fragment_example; // Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
String *json = json_example; // Specify "true" to return result as JSON instead of plaintext. (optional)

GetYearFactApi *apiInstance = [[GetYearFactApi alloc] init];

//  Get a fact about a year
[apiInstance yearYearGetWith:apiecoKey
    year:year
    fragment:fragment
    json:json
              completionHandler: ^(year output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];
var NumbersApi_ = require('numbers_api___');
var defaultClient = NumbersApi_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new NumbersApi_.GetYearFactApi()

var apiecoKey = apiecoKey_example; // {String} 

var year = year_example; // {String} The year of interest

var opts = { 
  'fragment': fragment_example, // {String} Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
  'json': json_example // {String} Specify "true" to return result as JSON instead of plaintext.
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.yearYearGet(apiecoKey, year, opts, callback);
using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class yearYearGetExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new GetYearFactApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var year = year_example;  // String | The year of interest
            var fragment = fragment_example;  // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional) 
            var json = json_example;  // String | Specify "true" to return result as JSON instead of plaintext. (optional) 

            try
            {
                //  Get a fact about a year
                year result = apiInstance.yearYearGet(apiecoKey, year, fragment, json);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling GetYearFactApi.yearYearGet: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\GetYearFactApi();
$apiecoKey = apiecoKey_example; // String | 
$year = year_example; // String | The year of interest
$fragment = fragment_example; // String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
$json = json_example; // String | Specify "true" to return result as JSON instead of plaintext.

try {
    $result = $api_instance->yearYearGet($apiecoKey, $year, $fragment, $json);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling GetYearFactApi->yearYearGet: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::GetYearFactApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::GetYearFactApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $year = year_example; # String | The year of interest
my $fragment = fragment_example; # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
my $json = json_example; # String | Specify "true" to return result as JSON instead of plaintext.

eval { 
    my $result = $api_instance->yearYearGet(apiecoKey => $apiecoKey, year => $year, fragment => $fragment, json => $json);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling GetYearFactApi->yearYearGet: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.GetYearFactApi()
apiecoKey = apiecoKey_example # String | 
year = year_example # String | The year of interest
fragment = fragment_example # String | Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”. (optional)
json = json_example # String | Specify "true" to return result as JSON instead of plaintext. (optional)

try: 
    #  Get a fact about a year
    api_response = api_instance.year_year_get(apiecoKey, year, fragment=fragment, json=json)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling GetYearFactApi->yearYearGet: %s\n" % e)

Parameters

Path parameters
Name Description
year*
String
The year of interest
Required
Header parameters
Name Description
apieco-key*
String
Required
Query parameters
Name Description
fragment
String
Add "?fragment=true" to return the fact as a sentence fragment that can be easily included as part of a larger sentence. This means that the first word is lowercase and ending punctuation is omitted. For trivia and math, a noun phrase is returned that can be used in a sentence like “We now have more users than [fact as fragment]!”.
json
String
Specify "true" to return result as JSON instead of plaintext.

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 405 - Invalid input