HingeSDK

SDK Python non ufficiale per l'API di Hinge. Interagisci programmaticamente con Hinge per ottenere raccomandazioni, inviare messaggi, scaricare media e automatizzare interazioni.

Autenticazione e Configurazione dell'Ambiente

Per utilizzare questo SDK, hai bisogno di credenziali di autenticazione valide. Puoi memorizzarle in un file .env o passarle direttamente al client.

Variabili Richieste

• BEARER_TOKEN: Il tuo token di autenticazione JWT (es. L2euNWN...).
• SESSION_ID: L'UUID della sessione corrente.
• USER_ID: Il tuo ID utente/giocatore univoco.

Come Ottenere le Credenziali

Metodo 1: Telefono Rootato / Proxy (Consigliato per Account Esistenti)

Se vuoi utilizzare il tuo account Hinge esistente senza rischiare flag dovuti a nuovi accessi da dispositivi, devi estrarre questi valori dal traffico di rete dell'app.

Nota: Devi farlo una sola volta per ottenere le variabili corrette. Dopo averle catturate, puoi utilizzare il metodo di accesso via SMS per le sessioni future.

1. Utilizza un dispositivo Android rootato o una configurazione proxy standard (ad es. con HTTP Toolkit o Charles Proxy) poiché Hinge non utilizza il certificate pinning.
2. Ispeziona le richieste HTTPS a prod-api.hingeaws.net o ad altri endpoint simili di Hinge.
3. Estrai i seguenti header/valori dai corpi delle richieste o delle risposte degli endpoint del profilo:
   • authorization (Bearer token)
   • x-session-id
   • x-device-id
   • x-install-id
   • User ID (spesso nel corpo della risposta come subjectId o simile)

Metodo 2: Accesso via SMS (Sperimentale)

Puoi generare nuove credenziali effettuando l'accesso tramite SMS attraverso l'SDK. Questo esegue un flusso di accesso nuovo.

from hingesdk.client import HingeClient

# These IDs must match the actual values associated with your account.
# You cannot use random UUIDs; they must align with the account's registered device.
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}")

Installazione

Clona il repository e installa il pacchetto:

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

Avvio Rapido

Ecco un esempio minimo per autenticarsi e ottenere raccomandazioni utente.

import os
from hingesdk.api import HingeAPIClient

# Initialize with credentials
client = HingeAPIClient(
    auth_token=os.getenv("BEARER_TOKEN"),
    session_id=os.getenv("SESSION_ID"),
    user_id=os.getenv("USER_ID")
)

# Fetch recommendations
recs = client.get_recommendations()
print(f"Successfully fetched recommendations request.")

Utilizzo ed Esempi

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='Hello, this is a test 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)

# Example: Get user info
tools.create_profile_json(
    source=ProfileSource.STANDOUTS,
    output_file="standouts.json"
)

# Example: Like a user 
with open("standouts.json", "r") as f:
    profiles = json.load(f)

personData = profiles["35582109789..."]

# Like a user's question
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": "I've been in Miami for a year and still haven't gone (╥﹏╥)"
    }
)
print(response)

# Like a user's photo
# 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": "So how many people have commented saying they've been here before?"
#     }
# )
# print(response)