Developer Center

开发者中心

Centro de Desarrolladores

Centre des Développeurs

Entwicklerzentrum

Complete integration process and API documentation for developers

为开发者提供完整的接入流程和API文档

Proceso de integración completo y documentación API para desarrolladores

Processus d'intégration complet et documentation API pour développeurs

Vollständiger Integrationsprozess und API-Dokumentation für Entwickler

Integration Process

对接流程

Proceso de Integración

Processus d'Intégration

Integrationsprozess

01

Business Cooperation

商务对接

Cooperación Comercial

Coopération Commerciale

Geschäftliche Zusammenarbeit

Sign cooperation agreement to establish partnership

签订合作协议建立合作关系

Firmar acuerdo de cooperación para establecer la asociación

Signer un accord de coopération pour établir un partenariat

Unterzeichnen Sie eine Kooperationsvereinbarung zur Partnerschaftsbildung

02

Technical Integration

技术对接

Integración Técnica

Intégration Technique

Technische Integration

Provide complete integration process and API documentation, dedicated technical marketing to assist customers in completing advertising integration; allocate backend system management account for cooperative customers to view data timely

为开发者提供完整的接入流程和API文档，专门的技术营销协助客户完成广告对接；分配后台系统管理账户，供合作客户及时查看数据

Proporcionar proceso de integración completo y documentación API, marketing técnico dedicado para ayudar a los clientes a completar la integración publicitaria; asignar cuenta de gestión del sistema backend para clientes cooperativos para ver datos oportunamente

Fournir un processus d'intégration complet et une documentation API, marketing technique dédié pour aider les clients à terminer l'intégration publicitaire; attribuer un compte de gestion du système backend aux clients coopératifs pour visualiser les données en temps opportun

Bereitstellung eines vollständigen Integrationsprozesses und API-Dokumentation, dediziertes technisches Marketing zur Unterstützung der Kunden bei der Werbeintegration; Zuweisung eines Backend-Systemverwaltungskontos für kooperative Kunden zur rechtzeitigen Datenanzeige

03

Ecosystem Operations & Growth

生态运营与增长

Operaciones y Crecimiento del Ecosistema

Opérations et Croissance de l'Écosystème

Ökosystem-Betrieb & Wachstum

We will conduct personalized and refined operations based on customer needs and traffic area, device models and other attributes, helping partners achieve business growth

我方将根据客户的需求以及流量区域、机型等属性进行个性化、精细化运营，助力合作伙伴实现业务增长

Realizaremos operaciones personalizadas y refinadas según las necesidades del cliente y el área de tráfico, modelos de dispositivos y otros atributos, ayudando a los socios a lograr el crecimiento empresarial

Nous mènerons des opérations personnalisées et raffinées basées sur les besoins des clients et la zone de trafic, les modèles d'appareils et otros atributos, aidant les partenaires à réaliser une croissance commerciale

Wir führen personalisierte und verfeinerte Betriebsabläufe basierend auf Kundenbedürfnissen und Traffic-Bereich, Gerätemodellen und anderen Attributen durch, um Partnern bei der Erreichung von Geschäftswachstum zu helfen

04

Experience Optimization & Validation

体验优化与验证

Optimización y Validación de la Experiencia

Optimisation et Validation de l'Expérience

Erlebnisoptimierung & Validierung

After completing the technical integration, we will assist customers in system validation to ensure that all functions can operate normally according to customer requirements, continuously optimizing user experience

完成技术对接后，我方会协助客户进行系统验证，确保各项功能能正常按照客户要求运行，持续优化用户体验

Después de completar la integración técnica, ayudaremos a los clientes en la validación del sistema para garantizar que todas las funciones puedan operar normalmente según los requisitos del cliente, optimizando continuamente la experiencia del usuario

Après avoir terminé l'intégration technique, nous aiderons les clients dans la validation du système pour garantir que toutes les fonctions puissent fonctionner normalement selon les exigences du client, en optimisant continuellement l'expérience utilisateur

Nach Abschluss der technischen Integration unterstützen wir Kunden bei der Systemvalidierung, um sicherzustellen, dass alle Funktionen gemäß Kundenanforderungen normal funktionieren, und optimieren kontinuierlich die Benutzererfahrung

05

View Data

查看数据

Ver Datos

Voir les Données

Daten Anzeigen

Daily revenue sharing and operational data will be displayed in our backend the next day, and customers can log in to view it themselves

每天的分成收益、运营数据将会隔天展示在我方的后台，客户可以自行登录查看

Los datos de reparto de ingresos diarios y operativos se mostrarán en nuestro backend al día siguiente, y los clientes pueden iniciar sesión para verlos ellos mismos

Le partage des revenus quotidiens et les données opérationnelles seront affichés dans notre backend le lendemain, et les clients peuvent se connecter pour les visualiser eux-mêmes

Tägliche Umsatzbeteiligung und Betriebsdaten werden am nächsten Tag in unserem Backend angezeigt, und Kunden können sich anmelden, um sie selbst einzusehen

06

Revenue Sharing

收益分成

Reparto de Ingresos

Partage des Revenus

Umsatzbeteiligung

Every month or every half month, we will conduct account settlement with customers based on specific sharing ratios

每月或每半个月，我方将根据特定的分成比例与客户进行对账结算

Cada mes o cada quincena, realizaremos la liquidación de cuentas con los clientes según proporciones de reparto específicas

Chaque mois ou toutes les deux semaines, nous effectuerons le règlement des comptes avec les clients sur la base de ratios de partage spécifiques

Jeden Monat oder alle zwei Wochen führen wir die Abrechnung mit Kunden auf der Grundlage spezifischer Aufteilungsverhältnisse durch

API Documentation

API文档

Documentación API

Documentation API

API-Dokumentation

Integrate our ecosystem with our comprehensive APIs

通过我们全面的API集成我们的生态系统

Integre nuestro ecosistema con nuestras API integrales

Intégrez notre écosystème avec nos API complètes

Integrieren Sie unser Ökosystem mit unseren umfassenden APIs

GET /api/games/list
Retrieve available game catalog listings 检索可用游戏目录列表 Recuperar listados de catálogo de juegos disponibles Récupérer les listes de catalogue de jeux disponibles Verfügbare Spielkatalog-Listings abrufen

Parameters

参数

Parámetros

Paramètres

Parameter

  • category - Game category filter 游戏类别筛选 Filtro de categoría de juego Filtre de catégorie de jeu Spielekategorie-Filter
  • limit - Number of items to return 返回项目数量 Número de elementos a devolver Nombre d'éléments à retourner Anzahl der zurückzugebenden Elemente
  • offset - Number of items to skip 跳过的项目数量 Número de elementos a omitir Nombre d'éléments à ignorer Anzahl der zu überspringenden Elemente
POST /api/games/upload
Deploy new game assets to the platform 将新游戏资源部署到平台 Implementar nuevos recursos de juego en la plataforma Déployer de nouveaux actifs de jeu sur la plateforme Neue Spielressourcen auf der Plattform bereitstellen

Parameters

参数

Parámetros

Paramètres

Parameter

  • game_file - Game binary file 游戏二进制文件 Archivo binario del juego Fichier binaire du jeu Spiel-Binärdatei
  • metadata - Game metadata (JSON) 游戏元数据(JSON) Metadatos del juego (JSON) Métadonnées du jeu (JSON) Spiel-Metadaten (JSON)
  • preview_images - Game preview images 游戏预览图片 Imágenes de vista previa del juego Images d'aperçu du jeu Spiel-Vorschaubilder
GET /api/analytics/performance
Access performance analytics for your games 访问游戏性能分析数据 Acceder a análisis de rendimiento para tus juegos Accéder aux analyses de performance pour vos jeux Auf Leistungsanalysen für Ihre Spiele zugreifen

Parameters

参数

Parámetros

Paramètres

Parameter

  • game_id - ID of the game 游戏ID ID del juego ID du jeu Spiel-ID
  • start_date - Start date for analytics 分析开始日期 Fecha de inicio para análisis Date de début pour l'analyse Startdatum für Analysen
  • end_date - End date for analytics 分析结束日期 Fecha de fin para análisis Date de fin pour l'analyse Enddatum für Analysen
  • metrics - Metrics to include in response 包含在响应中的指标 Métricas a incluir en la respuesta Métriques à inclure dans la réponse In der Antwort enthaltene Metriken
POST /api/monetization/setup
Configure monetization options for your games 为游戏配置变现选项 Configurar opciones de monetización para tus juegos Configurer les options de monétisation pour vos jeux Monetarisierungsoptionen für Ihre Spiele konfigurieren

Parameters

参数

Parámetros

Paramètres

Parameter

  • game_id - ID of the game 游戏ID ID del juego ID du jeu Spiel-ID
  • ad_types - Types of ads to display 显示的广告类型 Tipos de anuncios a mostrar Types d'annonces à afficher Anzuzeigende Anzeigentypen
  • placement - Ad placement settings 广告位置设置 Configuración de ubicación de anuncios Paramètres de placement des annonces Anzeigenplatzierungseinstellungen
  • frequency - Ad display frequency 广告显示频率 Frecuencia de visualización de anuncios Fréquence d'affichage des annonces Anzeigenanzeigehäufigkeit
GET /api/user/game-progress
Access user game progress and achievements 访问用户游戏进度和成就 Acceder al progreso y logros del juego del usuario Accéder à la progression et aux réalisations du jeu de l'utilisateur Auf Benutzerspiel-Fortschritt und Erfolge zugreifen

Parameters

参数

Parámetros

Paramètres

Parameter

  • user_id - ID of the user 用户ID ID del usuario ID de l'utilisateur Benutzer-ID
  • game_id - ID of the specific game 特定游戏的ID ID del juego específico ID du jeu spécifique ID des spezifischen Spiels
GET /api/revenue/report
Access revenue sharing reports 访问收益分成报告 Acceder a informes de reparto de ingresos Accéder aux rapports de partage des revenus Auf Umsatzbeteiligungsberichte zugreifen

Parameters

参数

Parámetros

Paramètres

Parameter

  • period - Reporting period 报告期间 Período de informe Période de rapport Berichtszeitraum
  • format - Report format (JSON/CSV) 报告格式(JSON/CSV) Formato de informe (JSON/CSV) Format du rapport (JSON/CSV) Berichtsformat (JSON/CSV)

API Integration Example API集成示例 Ejemplo de Integración API Exemple d'Intégration API API-Integrationsbeispiel 

// Initialize SDK with your API key
// 使用您的API密钥初始化SDK
// Inicializar SDK con su clave API
// Initialiser le SDK avec votre clé API
// SDK mit Ihrem API-Schlüssel initialisieren
const huaxunSDK = new HuaxunSDK('your-api-key-here');

// Access user game progress data
// 访问用户游戏进度数据
// Acceder a datos de progreso de juego del usuario
// Accéder aux données de progression de jeu de l'utilisateur
// Auf Benutzerspiel-Fortschrittsdaten zugreifen
huaxunSDK.getUserGameProgress('user-id', 'game-id')
  .then(progressData => {
    console.log('Game Progress:游戏进度：Progreso del Juego:Progression du Jeu :Spiel-Fortschritt:', progressData);
  });

// Deploy a new game
// 部署新游戏
// Implementar un nuevo juego
// Déployer un nouveau jeu
// Neues Spiel bereitstellen
const gameData = {
  title: 'My Premium Game我的优质游戏Mi Juego PremiumMon Jeu PremiumMein Premium-Spiel',
  category: 'puzzle',
  file: gameBinary,
  metadata: {
    description: 'An engaging puzzle game for all ages适合所有年龄段的有趣益智游戏Un atractivo juego de rompecabezas para todas las edadesUn jeu de puzzle engageant pour tous les âgesEin fesselndes Puzzle-Spiel für alle Altersgruppen',
    tags: ['puzzle', 'casual', 'family']
  }
};

huaxunSDK.uploadGame(gameData)
  .then(response => {
    console.log('Game deployed successfully:游戏部署成功：Juego implementado exitosamente:Jeu déployé avec succès :Spiel erfolgreich bereitgestellt:', response.gameId);
  });
# Initialize SDK with your API key
# 使用您的API密钥初始化SDK
# Inicializar SDK con su clave API
# Initialiser le SDK avec votre clé API
# SDK mit Ihrem API-Schlüssel initialisieren
API_KEY="your-api-key-here"

# Access user game progress data
# 访问用户游戏进度数据
# Acceder a datos de progreso de juego del usuario
# Accéder aux données de progression de jeu de l'utilisateur
# Auf Benutzerspiel-Fortschrittsdaten zugreifen
curl -X GET \
  "https://api.huaxun.com/api/user/game-progress?user_id=user-id&game_id=game-id" \
  -H "Authorization: Bearer $API_KEY"

# Deploy a new game
# 部署新游戏
# Implementar un nuevo juego
# Déployer un nuevo jeu
# Neues Spiel bereitstellen
curl -X POST \
  "https://api.huaxun.com/api/games/upload" \
  -H "Authorization: Bearer $API_KEY" \
  -F "title=My Premium Game" \
  -F "category=puzzle" \
  -F "file=@game.zip" \
  -F 'metadata={"description": "An engaging puzzle game for all ages", "tags": ["puzzle", "casual", "family"]}'
# Initialize SDK with your API key
# 使用您的API密钥初始化SDK
# Inicializar SDK con su clave API
# Initialiser le SDK avec votre clé API
# SDK mit Ihrem API-Schlüssel initialisieren
import huaxun_sdk

sdk = huaxun_sdk.HuaxunSDK(api_key='your-api-key-here')

# Access user game progress data
# 访问用户游戏进度数据
# Acceder a datos de progreso de juego del usuario
# Accéder aux données de progression de jeu de l'utilisateur
# Auf Benutzerspiel-Fortschrittsdaten zugreifen
progress_data = sdk.get_user_game_progress('user-id', 'game-id')
print('Game Progress:游戏进度：Progreso del Juego:Progression du Jeu :Spiel-Fortschritt:', progress_data)

# Deploy a new game
# 部署新游戏
# Implementar un nuevo juego
# Déployer un nouveau jeu
# Neues Spiel bereitstellen
game_data = {
    'title': 'My Premium Game我的优质游戏Mi Juego PremiumMon Jeu PremiumMein Premium-Spiel',
    'category': 'puzzle',
    'file': open('game.zip', 'rb'),
    'metadata': {
        'description': 'An engaging puzzle game for all ages适合所有年龄段的有趣益智游戏Un atractivo juego de rompecabezas para todas las edadesUn jeu de puzzle engageant pour tous les âgesEin fesselndes Puzzle-Spiel für alle Altersgruppen',
        'tags': ['puzzle', 'casual', 'family']
    }
}

response = sdk.upload_game(game_data)
print('Game deployed successfully:游戏部署成功：Juego implementado exitosamente:Jeu déployé avec succès :Spiel erfolgreich bereitgestellt:', response['gameId'])
// Initialize SDK with your API key
// 使用您的API密钥初始化SDK
// Inicializar SDK con su clave API
// Initialiser le SDK avec votre clé API
// SDK mit Ihrem API-Schlüssel initialisieren
HuaxunSDK sdk = new HuaxunSDK("your-api-key-here");

// Access user game progress data
// 访问用户游戏进度数据
// Acceder a datos de progreso de juego del usuario
// Accéder aux données de progression de jeu de l'utilisateur
// Auf Benutzerspiel-Fortschrittsdaten zugreifen
GameProgress progressData = sdk.getUserGameProgress("user-id", "game-id");
System.out.println("Game Progress:游戏进度：Progreso del Juego:Progression du Jeu :Spiel-Fortschritt: " + progressData);

// Deploy a new game
// 部署新游戏
// Implementar un nuevo juego
// Déployer un nouveau jeu
// Neues Spiel bereitstellen
GameData gameData = new GameData.Builder()
    .setTitle("My Premium Game我的优质游戏Mi Juego PremiumMon Jeu PremiumMein Premium-Spiel")
    .setCategory("puzzle")
    .setGameFile(new File("game.zip"))
    .setMetadata(new GameMetadata(
        "An engaging puzzle game for all ages适合所有年龄段的有趣益智游戏Un atractivo juego de rompecabezas para todas las edadesUn jeu de puzzle engageant pour tous les âgesEin fesselndes Puzzle-Spiel für alle Altersgruppen",
        Arrays.asList("puzzle", "casual", "family")
    ))
    .build();

UploadResponse response = sdk.uploadGame(gameData);
System.out.println("Game deployed successfully:游戏部署成功：Juego implementado exitosamente:Jeu déployé avec succès :Spiel erfolgreich bereitgestellt: " + response.getGameId());
// Initialize SDK with your API key
// 使用您的API密钥初始化SDK
// Inicializar SDK con su clave API
// Initialiser le SDK avec votre clé API
// SDK mit Ihrem API-Schlüssel initialisieren
sdk := huaxun.NewSDK("your-api-key-here")

// Access user game progress data
// 访问用户游戏进度数据
// Acceder a datos de progreso de juego del usuario
// Accéder aux données de progression de jeu de l'utilisateur
// Auf Benutzerspiel-Fortschrittsdaten zugreifen
progressData, err := sdk.GetUserGameProgress("user-id", "game-id")
if err != nil {
    log.Fatal(err)
}
fmt.Println("Game Progress:游戏进度：Progreso del Juego:Progression du Jeu :Spiel-Fortschritt:", progressData)

// Deploy a new game
// 部署新游戏
// Implementar un nuevo juego
// Déployer un nouveau jeu
// Neues Spiel bereitstellen
gameData := huaxun.GameData{
    Title:    "My Premium Game我的优质游戏Mi Juego PremiumMon Jeu PremiumMein Premium-Spiel",
    Category: "puzzle",
    File:     readFile("game.zip"),
    Metadata: huaxun.GameMetadata{
        Description: "An engaging puzzle game for all ages适合所有年龄段的有趣益智游戏Un atractivo juego de rompecabezas para todas las edadesUn jeu de puzzle engageant pour tous les âgesEin fesselndes Puzzle-Spiel für alle Altersgruppen",
        Tags:        []string{"puzzle", "casual", "family"},
    },
}

response, err := sdk.UploadGame(gameData)
if err != nil {
    log.Fatal(err)
}
fmt.Println("Game deployed successfully:游戏部署成功：Juego implementado exitosamente:Jeu déployé avec succès :Spiel erfolgreich bereitgestellt:", response.GameID)
// Initialize SDK with your API key
// 使用您的API密钥初始化SDK
// Inicializar SDK con su clave API
// Initialiser le SDK avec votre clé API
// SDK mit Ihrem API-Schlüssel initialisieren
HuaxunSDK sdk("your-api-key-here");

// Access user game progress data
// 访问用户游戏进度数据
// Acceder a datos de progreso de juego del usuario
// Accéder aux données de progression de jeu de l'utilisateur
// Auf Benutzerspiel-Fortschrittsdaten zugreifen
GameProgress progressData = sdk.getUserGameProgress("user-id", "game-id");
std::cout << "Game Progress:游戏进度：Progreso del Juego:Progression du Jeu :Spiel-Fortschritt: " << progressData.toString() << std::endl;

// Deploy a new game
// 部署新游戏
// Implementar un nuevo juego
// Déployer un nouveau jeu
// Neues Spiel bereitstellen
GameData gameData;
gameData.title = "My Premium Game我的优质游戏Mi Juego PremiumMon Jeu PremiumMein Premium-Spiel";
gameData.category = "puzzle";
gameData.file = readFile("game.zip");
gameData.metadata.description = "An engaging puzzle game for all ages适合所有年龄段的有趣益智游戏Un atractivo juego de rompecabezas para todas las edadesUn jeu de puzzle engageant pour tous les âgesEin fesselndes Puzzle-Spiel für alle Altersgruppen";
gameData.metadata.tags = {"puzzle", "casual", "family"};

UploadResponse response = sdk.uploadGame(gameData);
std::cout << "Game deployed successfully:游戏部署成功：Juego implementado exitosamente:Jeu déployé avec succès :Spiel erfolgreich bereitgestellt: " << response.gameId << std::endl;