Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Know Your Friend Reading

Introducing the Know Your Friend Reading API, an interactive way to uncover deeper insights into friendships and compatibility. This API helps users understand dynamics, strengths, and growth areas in their relationships — perfect for applications focused on connection and personal discovery.


Step by Step Know Your Friend Reading API Postman Testing Integration

Step by Step Know Your Friend Reading API Postman Testing Integration


API Endpoint for English

POST https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading

Guide: If you only need English, use this endpoint.


API Endpoint for other languages

POST https://astroapi-5-translator.divineapi.com/api/v3/know-your-friend-reading

Guide: If you want the response in any other language use this translator endpoint.


Supported Language Codes

Use the lan parameter in the request body to define your preferred response language.

Supported Reference Article:
https://support.divineapi.com/general-api-support/translating-apis-into-a-different-language

CodeLanguage
enEnglish
hiHindi
zhChinese
jaJapanese
arArabic
ruRussian
ptPortuguese
esSpanish
frFrench
deGerman
itItalian
nlDutch
plPolish
trTurkish
ukUkrainian
huHungarian
grGreek
bnBengali
maMarathi
tmTamil
tlTelugu
mlMalayalam
knKannada
taFilipino/Tagalog
bahIndonesian

Guide: Ensure that your translator configuration is up to date via DivineAPI Translator.


Headers

NameTypeDescription
Authorization*StringYour API Access Token. Example: Bearer {token}

Request Body

NameTypeDescription
api_key*StringYour DivineAPI Key (found on your dashboard).
lanStringLanguage code (default: en). How to update translator.
cards_countIntegerNumber of cards to display, eg: 1 (Allowed: 1/2/3/4/5, Default: 1)
card_imageIntegerCard image UI type, eg: 1 (Allowed: 1/2/3, Default: 1)

200: OK Successful

{
    "success": 1,
    "data": {
        "prediction": {
            "card": "THE CHARIOT",
            "result": "This person's dynamic and go-getter attitude is contagious, and you will find yourself drawn to their ambitious nature. The Chariot symbolizes victory, and this friend is always striving for success in all aspects of their life. They will encourage you to be more assertive and self-assured in your own pursuits. Their energy and enthusiasm will inspire you to take risks and follow your dreams. This friend is also reliable and dependable, and you can always count on them to be there for you when you need support.\r\n\r\nYou might be wondering how you can keep up with such an energetic friend, but don't worry. The Chariot's energy is not about wearing you down but lifting you up. Your friend's drive and determination will motivate you to achieve your own goals and aspirations. They may also be a good mentor or coach, guiding you towards success and helping you overcome obstacles. Remember to show your appreciation for this friend, as they will always be an invaluable source of inspiration and motivation in your life.",
            "image": "https://divineapi.com/admin/uploads/tarot_friend_or_foe/8.png",
            "image2": "https://divineapi.com/admin/uploads/tarot_friend_or_foe/8_2.jpg",
            "image3": "https://divineapi.com/admin/uploads/tarot_friend_or_foe/8_3.jpg"
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'lan="en"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading"

payload = {'api_key': '{Your API Key}',
'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
curl -X POST "https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading" \
  -H "Authorization: Bearer {Your Auth Token}" \
  --form 'api_key="{Your API Key}"' \
  --form 'lan="en"'
const FormData = require('form-data');
const axios = require('axios');

const form = new FormData();
form.append('api_key', '{Your API Key}');
form.append('lan', 'en');

const response = await axios.post('https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': 'Bearer {Your Auth Token}',
  }
});

console.log(response.data);
import requests

url = "https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading"
headers = {
    "Authorization": "Bearer {Your Auth Token}",
}
payload = {
    "api_key": "{Your API Key}",
    "lan": "en",
}

response = requests.post(url, headers=headers, data=payload)

print(response.json())
const formData = new FormData();
formData.append('api_key', '{Your API Key}');
formData.append('lan', 'en');

const response = await fetch('https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading', {
  method: 'POST',
  headers: {
      'Authorization': "Bearer {Your Auth Token}",
    },
  body: formData,
});

const data = await response.json();
console.log(data);
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading', [
    'headers' => [
        'Authorization' => 'Bearer {Your Auth Token}',
    ],
    'multipart' => [
        ['name' => 'api_key', 'contents' => '{Your API Key}'],
        ['name' => 'lan', 'contents' => 'en'],
    ],
]);

echo $response->getBody();
package main

import (
    "bytes"
    "fmt"
    "mime/multipart"
    "net/http"
    "io"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    writer.WriteField("api_key", "{Your API Key}")
    writer.WriteField("lan", "en")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading", body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("Authorization", "Bearer {Your Auth Token}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body2, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body2))
}
import okhttp3.*;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();

        RequestBody body = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("api_key", "{Your API Key}")
            .addFormDataPart("lan", "en")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading")
            .post(body)
            .addHeader("Authorization", "Bearer {Your Auth Token}")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}
import Foundation

let url = URL(string: "https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var bodyData = Data()
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("{Your API Key}\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("en\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = bodyData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()
import okhttp3.*

fun main() {
    val client = OkHttpClient()

    val body = MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("api_key", "{Your API Key}")
        .addFormDataPart("lan", "en")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading")
        .post(body!!)
        .addHeader("Authorization", "Bearer {Your Auth Token}")
        .build()

    client.newCall(request).execute().use { response ->
        println(response.body?.string())
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}");

        var content = new MultipartFormDataContent();
        content.Add(new StringContent("{Your API Key}"), "api_key");
        content.Add(new StringContent("en"), "lan");

        var response = await client.PostAsync("https://astroapi-5.divineapi.com/api/v3/know-your-friend-reading", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}
Response 200
{
    "success": 1,
    "data": {
        "cards": [
            {
                "card": "THE HIGH PRIESTESS",
                "result": "You might find it hard to approach the High Priestess at first, but don't be discouraged. This person is worth getting to know. As a wise and introspective individual, your friend is highly intuitive and can offer valuable insights into any situation. The High Priestess has a way of seeing through the surface and getting to the heart of the matter. With this friend by your side, you will feel more confident in your decisions and be better equipped to handle any challenges that come your way.\r\n\r\nThis friend may not be the most outgoing or social person, but that doesn't mean they don't care deeply about their relationships. In fact, they value deep and meaningful connections over superficial ones. If you are patient and understanding, you will earn their trust and loyalty. Once you've established a strong bond with the High Priestess, you'll find that you can confide in them and they will always have your best interests at heart.\r\n\r\nThe friendship you form with the High Priestess is likely to be spiritually enriching as well. This person is highly attuned to their own intuition and can help you tap into your own inner wisdom. By learning to trust yourself and your instincts, you will be better equipped to navigate life's challenges and make decisions that align with your true self. In short, a friendship with the High Priestess is not only fulfilling but transformative.",
                "image": "https://divineapi.com/admin/uploads/tarot_friend_or_foe/3.png"
            }
        ]
    }
}