DOC
Accueil/ Projets/ KOBIKE Tracking Notifier/ Guide 02 - Compte développeur WeCom (企业微信) - API Smart Sheet

Guide 02 - Compte développeur WeCom (企业微信) - API Smart Sheet

⛔ CADUC (2026-07-13). Le document source est un tableur classique /sheet/ (在线表格), pas un Smart Sheet (智能表格) → l'API wedoc/smartsheet de ce guide est inutilisable. Chemin retenu : guide 07 - OpenAPI polling (Voie A). Guide conservé pour historique uniquement. Voir ADR 0001.

Objectif : disposer des identifiants d'API WeCom pour lire les enregistrements d'une Smart Sheet (智能表格).

1. Condition d'éligibilité

L'API wedoc/smartsheet ne fonctionne que si le document est une Smart Sheet (智能表格), pas un tableur Docs classique. À vérifier au préalable (guide 01, §5).

2. Créer/rejoindre une entreprise WeCom

  1. Aller sur https://work.weixin.qq.com et créer (ou rejoindre) une entreprise (企业).
  2. La vérification d'entreprise (企业认证) est généralement requise pour les API avancées ; sans elle, certaines API sont limitées.

3. Récupérer les identifiants d'API

Dans la console d'administration WeCom (管理后台) :

  • CorpID (企业ID) : 我的企业 → 企业信息 → tout en bas, 企业ID.
  • Secret (应用Secret) : créer une application interne (应用管理 → 自建 → 创建应用), puis récupérer son Secret. Pour les WeDoc/Smart Sheets, utiliser l'application ayant les droits sur les documents.
  • Autoriser l'IP du serveur : dans l'app, renseigner 企业可信IP avec l'IP publique du VPS (Coolify) qui appellera l'API.

4. Obtenir un access_token

GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=CORPID&corpsecret=SECRET

Réponse : { "access_token": "...", "expires_in": 7200 }. Le token est valable ~2 h → à mettre en cache et rafraîchir (nœud n8n dédié).

5. Lire les enregistrements d'une Smart Sheet

POST https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/get_records?access_token=ACCESS_TOKEN
{
  "docid":  "<docid de la Smart Sheet>",
  "sheet_id": "<id de la feuille>",
  "offset": 0,
  "limit": 100
}
  • docid : identifiant du document (voir guide 01).
  • sheet_id : identifiant de la feuille/onglet.
  • Paginer avec offset/limit pour ~10k lignes.

6. Logique de polling (si activé)

  1. Nœud Cron n8n (intervalle à calibrer - attention aux délais chinois).
  2. Récupérer les records → comparer au contenu de PostgreSQL (delta).
  3. Pour les nouvelles lignes avec tracking_number : vérification anti-doublon groupée (voir rapport_0001 §6) puis envoi.

Checklist

  • Document confirmé comme Smart Sheet (智能表格).
  • CorpID + Secret récupérés.
  • IP du VPS ajoutée aux IP de confiance.
  • get_records testé et paginé.

Ressources