# checkin-first-server

**Repository Path**: chore25/checkin-first-server

## Basic Information

- **Project Name**: checkin-first-server
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-28
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 入住先查后端示例

这个后端用于生成小程序码。小程序前端不能直接调用微信小程序码接口，因为接口依赖服务端凭证，必须放在服务器环境变量里。

## 1. 环境变量

复制 `.env.example`，在你的服务器环境中配置：

```bash
# 微信云托管默认探测 80 端口；本项目默认监听 80。
# 一般不需要配置 PORT。
WECHAT_APPID=wx2e3b3e4edee808e0
WECHAT_APPSECRET=你的服务端凭证
MINIPROGRAM_PAGE=pages/index/index
```

不要把真实服务端凭证提交到代码仓库。

## 2. 启动

```bash
npm install
npm start
```

健康检查：

```bash
curl https://你的域名/health
```

生成小程序码：

```bash
curl -X POST https://你的域名/api/minicode \
  -H "Content-Type: application/json" \
  -d "{\"scene\":\"home\",\"page\":\"pages/index/index\",\"envVersion\":\"trial\"}" \
  --output minicode.jpg
```

微信登录：

```bash
curl -X POST https://你的域名/api/login \
  -H "Content-Type: application/json" \
  -d "{\"code\":\"前端 wx.login 拿到的 code\"}"
```

接口会返回 `openid`、`unionid`（如有）和业务 `token`。不要把微信 `session_key` 返回给前端。

## 3. 小程序配置

在小程序项目里修改：

```js
// 入住先查_miniprogram/config/env.js
module.exports = {
  cloudEnvId: "",
  backendBaseUrl: "https://你的域名"
};
```

然后去微信公众平台：

`开发管理 -> 开发设置 -> 服务器域名`

把 `https://你的域名` 加入 `request 合法域名`。

## 4. HTTPS 要求

微信小程序正式环境要求后端域名必须是 HTTPS，且证书有效。开发工具里可以临时勾选“不校验合法域名”，但真机和上线前必须配置合法域名。