HingeSDK

Hinge API के लिए अनौपचारिक Python SDK. Hinge के साथ प्रोग्रामेटिक रूप से इंटरैक्ट करें ताकि सिफारिशें प्राप्त करें, संदेश भेजें, मीडिया डाउनलोड करें और स्वचालित इंटरैक्शन करें।

प्रमाणीकरण और वातावरण सेटअप

इस SDK का उपयोग करने के लिए, आपको मान्य प्रमाणीकरण क्रेडेंशियल्स की आवश्यकता है। आप इन्हें .env फ़ाइल में संग्रहीत कर सकते हैं या सीधे क्लाइंट को पास कर सकते हैं।

आवश्यक चर

• BEARER_TOKEN: आपका JWT प्रमाणीकरण टोकन (जैसे, L2euNWN...)।
• SESSION_ID: वर्तमान सत्र UUID।
• USER_ID: आपकी अद्वितीय उपयोगकर्ता/खिलाड़ी आईडी।

क्रेडेंशियल्स कैसे प्राप्त करें

विधि 1: रूटेड फोन / प्रॉक्सी (मौजूदा खातों के लिए अनुशंसित)

यदि आप नए डिवाइस लॉगिन से फ़्लैग होने के जोखिम के बिना अपने मौजूदा Hinge खाते का उपयोग करना चाहते हैं, तो आपको ऐप के नेटवर्क ट्रैफ़िक से इन मानों को निकालना होगा।

नोट: सही चर प्राप्त करने के लिए आपको यह केवल एक बार करने की आवश्यकता है। उन्हें कैप्चर करने के बाद, आप भविष्य के सत्रों के लिए SMS लॉगिन विधि का उपयोग कर सकते हैं।

1. एक रूटेड एंड्रॉइड डिवाइस या एक मानक प्रॉक्सी सेटअप (जैसे HTTP Toolkit या Charles Proxy के साथ) का उपयोग करें क्योंकि Hinge सर्टिफिकेट पिनिंग का उपयोग नहीं करता है।
2. prod-api.hingeaws.net या समान Hinge एंडपॉइंट्स पर HTTPS अनुरोधों का निरीक्षण करें।
3. प्रोफ़ाइल एंडपॉइंट्स के अनुरोध या प्रतिक्रिया बॉडी से निम्नलिखित हेडर/मान निकालें:
   • authorization (Bearer टोकन)
   • x-session-id
   • x-device-id
   • x-install-id
   • User ID (अक्सर प्रतिक्रिया बॉडी में subjectId या समान के रूप में)

विधि 2: SMS लॉगिन (प्रायोगिक)

आप SDK के माध्यम से SMS के ज़रिए लॉगिन करके नए क्रेडेंशियल्स उत्पन्न कर सकते हैं। यह एक ताज़ा लॉगिन प्रवाह करता है।

from hingesdk.client import HingeClient

# ये आईडी आपके खाते से जुड़े वास्तविक मानों से मेल खानी चाहिए।
# आप रैंडम UUID का उपयोग नहीं कर सकते; उन्हें खाते के पंजीकृत डिवाइस के अनुरूप होना चाहिए।
client = HingeClient.login_with_sms(
    phone_number="+15551234567", 
    device_id="your_device_id_uuid", 
    install_id="your_install_id_uuid" 
)

print(f"BEARER_TOKEN={client.auth_token}")
print(f"SESSION_ID={client.session_id}")
print(f"USER_ID={client.user_id}")

स्थापना

रिपॉजिटरी को क्लोन करें और पैकेज स्थापित करें:

git clone https://github.com/reedgraff/hingesdk
cd hingesdk
pip install .

त्वरित प्रारंभ

यहाँ प्रमाणीकरण और उपयोगकर्ता सिफारिशें प्राप्त करने का एक न्यूनतम उदाहरण है।

import os
from hingesdk.api import HingeAPIClient

# क्रेडेंशियल्स के साथ प्रारंभ करें
client = HingeAPIClient(
    auth_token=os.getenv("BEARER_TOKEN"),
    session_id=os.getenv("SESSION_ID"),
    user_id=os.getenv("USER_ID")
)

# सिफारिशें प्राप्त करें
recs = client.get_recommendations()
print(f"सिफारिशें अनुरोध सफलतापूर्वक प्राप्त किया गया।")

उपयोग और उदाहरण

from hingesdk.client import HingeAPIClient

auth_token = 'your_auth_token'
user_id = 'your_user_id'

client = HingeAPIClient(auth_token=auth_token, user_id=user_id)
response = client.send_message(
    subject_id='receiver_id',
    message='नमस्ते, यह एक परीक्षण संदेश है!'
)
print(response)

from hingesdk.api import HingeAPIClient

client = HingeAPIClient(auth_token=auth_token, user_id=user_id)
recommendations = client.get_recommendations()
print(recommendations)

from hingesdk.tools import HingeTools
from hingesdk.api import HingeAPIClient
from hingesdk.media import HingeMediaClient

api_client = HingeAPIClient(auth_token=auth_token, user_id=user_id)
media_client = HingeMediaClient(auth_token=auth_token)

tools = HingeTools(api_client, media_client)
tools.download_recommendation_content(output_path='path_to_save_images')

import os
import json
from hingesdk.tools import HingeTools
from hingesdk.api import HingeAPIClient
from hingesdk.media import HingeMediaClient

auth_token = os.getenv("BEARER_TOKEN")
session_id = os.getenv("SESSION_ID")
user_id = os.getenv("USER_ID")

api_client = HingeAPIClient(
    auth_token=auth_token,
    session_id=session_id,
    user_id=user_id
)
media_client = HingeMediaClient(auth_token=auth_token)
tools = HingeTools(api_client, media_client)

# उदाहरण: उपयोगकर्ता जानकारी प्राप्त करें
tools.create_profile_json(
    source=ProfileSource.STANDOUTS,
    output_file="standouts.json"
)

# उदाहरण: किसी उपयोगकर्ता को लाइक करें 
with open("standouts.json", "r") as f:
    profiles = json.load(f)

personData = profiles["35582109789..."]

# किसी उपयोगकर्ता के प्रश्न को लाइक करें
questionIDToLike = "5c4a346828fd883a24..."
response = api_client.like_profile(
    subject_id=personData["interaction_data"]["subject_id"],
    rating_token=personData["interaction_data"]["rating_token"],
    prompt={
        "questionId": questionIDToLike,
        "response": "मैं एक साल से मियामी में हूँ और अभी भी नहीं गया (╥﹏╥)"
    }
)
print(response)

# किसी उपयोगकर्ता की फ़ोटो को लाइक करें
# photoIDToLike = "2c6411ac-66e4-4194-..."
# response = api_client.like_profile(
#     subject_id=personData["interaction_data"]["subject_id"],
#     rating_token=personData["interaction_data"]["rating_token"],
#     photo={
#         "contentId": photoIDToLike,
#         "comment": "तो कितने लोगों ने टिप्पणी की है कि वे पहले यहाँ आ चुके हैं?"
#     }
# )
# print(response)