tencentcloudbase/auth-wechat-miniprogram

Guide d'authentification native pour mini-programmes WeChat avec CloudBase. Utilisez cette compétence lorsque vous avez besoin de gérer l'identité des mini-programmes, d'accéder à OPENID/UNIONID ou de configurer le comportement d'authentification `wx.cloud` dans des projets où la connexion est native et automatique.

Qu'est-ce que auth-wechat-miniprogram ?

Cette compétence fournit un guide complet pour l'authentification native des mini-programmes WeChat via CloudBase. Elle est conçue pour les développeurs qui ont besoin de gérer l'identité des utilisateurs dans leurs mini-programmes, en accédant à des identifiants uniques comme OPENID et UNIONID, ou en configurant le comportement d'authentification automatique avec `wx.cloud`. La compétence détaille les étapes pour implémenter une connexion native (sans interface utilisateur tierce) et automatique, où le mini-programme s'authentifie dès l'ouverture. Elle couvre l'utilisation de l'API `wx.cloud.callFunction` pour les opérations backend, ainsi que la configuration côté serveur CloudBase pour gérer les sessions et les jetons d'accès. Cela est particulièrement utile dans les projets WeChat où l'expérience utilisateur doit être fluide et sans friction, tout en respectant les normes de sécurité de la plateforme WeChat. La documentation inclut des exemples de code, des explications sur les flux d'authentification, et des conseils pour le débogage avec les outils de développement WeChat.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tencentcloudbase/skills/tree/main/skills/auth-wechat-miniprogram

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait auth-wechat-miniprogram ?

Guide d'authentification native pour mini-programmes WeChat avec CloudBase. Utilisez cette compétence lorsque vous avez besoin de gérer l'identité des mini-programmes, d'accéder à OPENID/UNIONID ou de configurer le comportement d'authentification wx.cloud dans des projets où la connexion est native et automatique.

Introduction

Ce guide explique comment mettre en place l'authentification native des mini-programmes WeChat en utilisant CloudBase. L'authentification native signifie que le mini-programme gère lui-même le flux de connexion, sans passer par des interfaces d'authentification tierces. L'authentification automatique permet au mini-programme d'être connecté dès son ouverture, améliorant ainsi l'expérience utilisateur.

Prérequis

  • Un projet CloudBase activé
  • Un mini-programme WeChat enregistré
  • Les clés d'API nécessaires (AppID, AppSecret)

Étapes d'implémentation

1. Configuration côté client (mini-programme)

Dans le code du mini-programme, utilisez l'API wx.cloud.callFunction pour appeler une fonction Cloud qui gère l'authentification.

wx.cloud.callFunction({
  name: 'login',
  success: res => {
    console.log(res.result.openid)
  },
  fail: err => {
    console.error(err)
  }
})

2. Configuration côté serveur (CloudBase)

Créez une fonction Cloud nommée login qui utilise le SDK CloudBase pour gérer l'authentification.

exports.main = async (event, context) => {
  const wxContext = cloud.getWXContext()
  return {
    openid: wxContext.OPENID,
    unionid: wxContext.UNIONID
  }
}

3. Activation du mode automatique

Pour une authentification automatique, ajoutez le code suivant dans la fonction onLaunch du mini-programme.

App({
  onLaunch: function () {
    wx.cloud.init({
      env: 'your-env-id'
    })
    // Authentification automatique
    wx.cloud.callFunction({
      name: 'login',
      success: res => {
        wx.setStorageSync('userInfo', res.result)
      }
    })
  }
})

Gestion des erreurs

Assurez-vous de gérer les erreurs potentielles, comme les échecs de réseau ou les jetons expirés. Utilisez try/catch ou les callbacks d'erreur appropriés.

Références

Support

Si vous rencontrez des problèmes, consultez la documentation officielle ou ouvrez une issue sur le dépôt GitHub.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

tencentcloudbase/ai-model-wechat

Use this skill for WeChat Mini Program AI via wx.cloud.extend.AI (小程序, 企业微信小程序, wx.cloud apps). Features generateText and streamText with callbacks (onText, onEvent, onFinish). Models via wx.cloud.extend.AI.createModel with groups hunyuan-exp (小程序成长计划), cloudbase (main managed), or custom-*. Model IDs (deepseek-v4-flash, deepseek-v3.2, hunyuan-2.0-instruct-20251111, glm-5, kimi-k2.6) go in the data wrapper model field. API differs from JS/Node SDK — streamText needs data wrapper, generateText returns raw response. MUST run two-step preflight before code — see body. Keywords: Mini Program AI, wx.cloud.extend.AI, 小程序成长计划, ai_miniprogram_inspire_plan, Token Credits 资源包, generateText, streamText, createModel, hunyuan-exp, TokenHub, Hunyuan, DeepSeek, GLM, Kimi, MiniMax. NOT for browser/Web (use ai-model-web), Node.js backend (use ai-model-nodejs), or image generation (use ai-model-nodejs).

tencentcloudbase/cloudbase-document-database-in-wechat-miniprog

Use CloudBase document database WeChat MiniProgram SDK to query, create, update, and delete data. Supports complex queries, pagination, aggregation, and geolocation queries.

tencentcloudbase/cloudbase-platform

CloudBase platform overview and routing guide. This skill should be used when users need high-level capability selection, platform concepts, console navigation, or cross-platform best practices before choosing a more specific implementation skill.

tencentcloudbase/cloud-functions

CloudBase function runtime guide for building, deploying, and debugging your own Event Functions or HTTP Functions. This skill should be used when users need application runtime code on CloudBase, not when they are merely calling CloudBase official platform APIs.

tencentcloudbase/miniprogram-development

WeChat Mini Program development skill for building, debugging, previewing, testing, publishing, and optimizing mini program projects. This skill should be used when users ask to create, develop, modify, debug, preview, test, deploy, publish, launch, review, or optimize WeChat Mini Programs, mini program pages, components, `tabBar`, routing, navigation, icon assets, project structure, project configuration, `project.config.json`, `appid` setup, device preview, real-device validation, WeChat Developer Tools workflows, `miniprogram-ci` preview/upload flows, or mini program release processes. It should also be used when users explicitly mention CloudBase, `wx.cloud`, Tencent CloudBase, 腾讯云开发, or 云开发 in a mini program project.

tencentcloudbase/spec-workflow

Use when medium-to-large changes need explicit requirements, technical design, and task planning before implementation, especially for multi-module work, unclear acceptance criteria, or architecture-heavy requests.

tencentcloudbase/ui-design

Use when users need visual direction, interface hierarchy, layout decisions, design specifications, or prototypes before implementing a Web or mini program UI.

tencentcloudbase/web-development

Use when users need to implement, integrate, debug, build, deploy, or validate a Web frontend after the product direction is already clear, especially for React, Vue, Vite, browser flows, or CloudBase Web integration.

Skills associés