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 HIEROPHANT",
                "result": "The Pope's message is a strong reminder that this friend's wisdom and guidance will be invaluable to you on your journey towards spiritual growth. You can trust this friend with your deepest thoughts and feelings, knowing that they will offer you compassion and understanding. They are likely to be a spiritual mentor, helping you to connect with your higher self and guiding you towards the path of self-discovery.\r\n\r\nHowever, it is important to remember that this friendship is a two-way street. You too should be willing to offer support, encouragement, and guidance whenever your friend needs it. You may find yourself taking on different roles, such as being their confidante, cheerleader, or even a source of inspiration.\r\n\r\nIt is also important to maintain healthy boundaries in this friendship, as it can be easy to become emotionally dependent on someone who offers such valuable support. Take the time to check in with yourself and ensure that you are not neglecting your own needs and personal growth.\r\n\r\nOverall, this friendship is a rare and precious gift that should be cherished and nurtured. Together, you can create a deep and meaningful bond that transcends the superficialities of everyday life and brings you closer to your true self.",
                "image": "https://divineapi.com/admin/uploads/tarot_friend_or_foe/6.png"
            }
        ]
    }
}