Начало работы с NumerologyAPI¶

Этот гайд проведет вас через следующие этапы:

• создание учетной записи разработчика
• генерацию API-ключа
• понимание аутентификации
• отправку первого запроса к API

NumerologyAPI предоставляет более 203 готовых к использованию конечных точек, охватывающих:

• расчеты нумерологии
• астрологические данные
• совместимость знаков зодиака
• ангельские числа
• интерпретации натальной карты

Все конечные точки поддерживают многоязычные ответы.

1. Создайте свою учетную запись разработчика¶

Рекомендуемый способ доступа к NumerologyAPI – через официальную платформу для разработчиков.

1. Откройте панель управления разработчиком https://dashboard.numerologyapi.com

2. Создайте свою учетную запись

3. Сгенерируйте ключ API для вашей организации

4. Пополните баланс (оплата по мере использования)

Ваш ключ API будет выглядеть примерно так:

tnea_xxxxxxxxxxxxxxxxx

2. Базовый URL¶

Все запросы отправляются на шлюз NumerologyAPI.

Пример конечной точки:

https://api.numerologyapi.com/api/v1/life_path

3. Аутентификация¶

Каждый запрос должен содержать ваш ключ API.

x-api-key: YOUR_API_KEY

Примеры заголовков запроса:

GET /api/v1/life_path HTTP/1.1
Host: api.numerologyapi.com
x-api-key: YOUR_API_KEY

4. Первый запрос – Номер жизненного пути¶

Запрос GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  --header "x-api-key: YOUR_API_KEY"

5. Вариант POST (JSON-тело)¶

Некоторые конечные точки также поддерживают запросы POST.

curl --request POST \
  --url https://api.numerologyapi.com/api/v1/life_path \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
  }'

6. Поддержка языков¶

Все конечные точки поддерживают необязательный параметр lang.

Пример:

?lang=fr

Поддерживаемые языки:

Пример запроса:

/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=es

7. Примеры кода¶

Python (requests)¶

import requests

url = "https://api.numerologyapi.com/api/v1/life_path"

params = {
    "birth_year": 1990,
    "birth_month": 5,
    "birth_day": 15
}

headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

PHP (cURL)¶

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "x-api-key: YOUR_API_KEY"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

?>

JavaScript (Fetch)¶

const url = new URL("https://api.numerologyapi.com/api/v1/life_path");

url.searchParams.append("birth_year", "1990");
url.searchParams.append("birth_month", "5");
url.searchParams.append("birth_day", "15");

fetch(url, {
    method: "GET",
    headers: {
        "x-api-key": "YOUR_API_KEY"
    }
})
.then(r => r.json())
.then(console.log);

Node.js (axios)¶

const axios = require("axios");

axios.get("https://api.numerologyapi.com/api/v1/life_path", {
  params: {
    birth_year: 1990,
    birth_month: 5,
    birth_day: 15
  },
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
.then(res => console.log(res.data));

8. Модель выставления счетов¶

NumerologyAPI использует систему выставления счетов на основе кредитов.

1 API request = 1 credit
1 USD = 3,921.57 credits

Кредиты используются для всех более 200 конечных точек.

Подробную информацию можно найти в разделе Цены.

9. Доступ через RapidAPI¶

Numerology API также доступен на RapidAPI для разработчиков, уже использующих эту платформу.

Для RapidAPI требуются следующие заголовки:

x-rapidapi-key
x-rapidapi-host

Пример конечной точки:

https://the-numerology-api.p.rapidapi.com/life_path

Доступ к ней здесь:

https://rapidapi.com/dakidarts-dakidarts-default/api/the-numerology-api

10. Дальнейшие шаги¶

Теперь, когда вы выполнили свой первый запрос:

• Изучите Справочник API для всех конечных точек
• Ознакомьтесь с Ценами, чтобы понять кредиты
• Просмотрите Список изменений для получения обновлений

Теперь вы готовы интегрировать NumerologyAPI в ваше приложение.