nest wechat 다운로드 - nest wechat 소스 코드 다운로드

nest wechat

AI 소스 코드

0.2.50

다운로드

네스트-위챗

WeChat 공식 계정, WeChat 프로그램 개발, WeChat 미니 게임, WeChat 결제 및 기업 WeChat 및 기타 서버 측 API Nestjs 모듈 캡슐화. 도구 클래스로 직접 사용할 수도 있습니다.

Nest-wechat은 자영업을 위한 패키지입니다. 사용해야 하는 API가 아직 제공되지 않는 경우, 저에게 문제를 제출해 주시면 최대한 빨리 해결해 드리겠습니다.

_{중국어 문서}

빠른 시작

설치하다

 npm i --nest-wechat 저장

Nestjs 모듈 소개

등록방법 등록

 import { 모듈 } from '@nestjs/common';import { WeChatModule } from 'nest-wechat';@Module({
imports: [WeChatModule.register({appId: 'your app id', secret: 'your secret'})],})export class AppModule {}

forRoot 구성 등록

 '@nestjs/common'에서 가져오기 { CACHE_MANAGER, 모듈 }; '@nestjs/config'에서 가져오기 { ConfigModule, ConfigService }; 'cache-manager'에서 가져오기 { 캐시 }; 'nest-wechat에서 가져오기 { RedisCache, WeChatModule } ';@기준 치수({
가져오기: [ConfigModule.forRoot({ envFilePath: '.env.test.local',}),WeChatModule.forRootAsync({ 가져오기: [ConfigModule], 주입: [ConfigService, CACHE_MANAGER], useFactory: (configService: ConfigService, 캐시: 캐시) => ({appId: configService.get('WX_APPID'), 비밀: configService.get('WX_SECRET'), 토큰: configService.get('WX_TOKEN'), 인코딩AESKey: configService.get('WX_AESKEY'), 캐시 어댑터: 새로운 RedisCache(캐시), 디버그: 사실, }),}),
]}) 내보내기 클래스 AppModule {}

도구 소개

 import { WeChatService } from 'nest-wechat';const service = new WeChatService({ appId: '앱 ID', secret: '비밀'});

글로벌 인터페이스

ICache

 /** * 캐시 인터페이스, 캐시를 사용자 정의해야 하는 경우 이 인터페이스를 구현하십시오. * * 캐시 인터페이스, 필요한 경우 이 인터페이스를 구현하십시오.
get<T>(키: 문자열): Promise<T>;
// eslint-disable-next-line @typescript-eslint/no-explicit-any
설정(키: 문자열, 값: 임의): void;
제거(키: 문자열): 부울;
닫기(): 무효;}

WeChatService 속성 및 메서드

구성: WeChatModuleOptions

읽기 및 쓰기 속성을 구성하고 다음을 입력합니다. WeChatModuleOptions

캐시 어댑터: ICache

캐시 어댑터 읽기 및 쓰기 속성, 유형: ICache, 기본값은 Map에 의해 구현된 캐시입니다.

WeChat 공개 계정 API

웹 인증

getAccessTokenByCode

 공용 비동기 getAccessTokenByCode(코드: 문자열, _appId?: 문자열, _secret?: 문자열): Promise<UserAccessTokenResult>;

올바르게 반환

 { "access_token":"ACCESS_TOKEN", "expires_in":7200, "refresh_token":"REFRESH_TOKEN", "openid":"OPENID", "scope":"SCOPE" }

오류 반환

 {"errcode": 40029,"errmsg": "잘못된 코드"}

getUserInfo

공식 계정은 사용자 정보를 가져옵니다

 public async getUserInfo (accessToken: 문자열, openid: 문자열, lang: 'zh_CN' | 'zh_TW' | 'en' = 'zh_CN'): Promise<UserInfoResult>;

올바르게 반환

 {
"openid": "OPENID", "닉네임": NICKNAME,
"성별": 1, "지방":"PROVINCE", "도시":"CITY", "국가":"국가", "headimgurl":"https://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/46", "권한":[ "PRIVILEGE1" "PRIVILEGE2" ], "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"}

오류 반환

 { "errcode":40003, "errmsg":" 잘못된 openid "}

액세스 토큰 받기

getAccountAccessToken

 public async getAccountAccessToken (_appId?: 문자열, _secret?: 문자열): Promise<AccountAccessTokenResult>;

올바르게 반환

 { "액세스_토큰": "52_s0Mcl3E3DBKs12rthjxG8_DOvsIC4puV9A34WQR6Bhb_30TW9W9BjhUxDRkyph-hY9Ab2QS03Q8w ZBe5UkA1k0q0hc17eUDZ7vAWItl4iahnhq_57dCoKc1dQ3AfiHUKGCCMJ2NcQ0BmbBRIKBEgAAAPGJ", "expires_in": 7200}

오류 반환

 { "errcode": 40013, "errmsg": "잘못된 앱 ID"}

자격 증명을 호출하는 안정적인 버전 인터페이스 얻기

getStableAccessToken

 public async getStableAccessToken (_appId?: 문자열, _secret?: 문자열, force = false): Promise<AccountAccessTokenResult>;

jsapi_ticket 받기

getJSAPiTicket

 공용 비동기 getJSApiTicket (_appId?: 문자열, _secret?: 문자열): Promise<TicketResult>;

데이터 반환

 { "errcode": 0, "errmsg": "ok", "티켓": "bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA", "expires_in": 7200}

JS-SDK는 권한 서명을 사용합니다.

jssdk서명

 public async jssdkSignature(url: string): Promise<SignatureResult>; public async jssdkSignature(url: string, appId: string, secret:string): Promise<SignatureResult>;

템플릿 메시지 보내기

보내기템플릿메시지

 공용 비동기 sendTemplateMessage(메시지: TemplateMessage, appId?: 문자열, 비밀?: 문자열): Promise<DefaultRequestResult & { msgid: string }>;

매개변수를 사용하여 QR 코드 생성

QR코드 생성

 공개 비동기 createQRCode(데이터: AccountCreateQRCode, appId?: 문자열, 비밀?: 문자열): Promise<AccountCreateQRCodeResult>;

티켓을 QR코드로 교환하세요

쇼QR코드

 공개 showQRCode(티켓: 문자열): Promis<Buffer>;

서버 구성을 입력하세요.

체크시그니처익스프레스

 WeChatService.checkSignatureExpress(req: 요청, res: 응답);

용법:

 @Get('push')async pushTest (@Req() req: 요청, @Res() res: 응답) {
this.service.checkSignatureExpress(req, res);}

이벤트 푸시 수신

메시지PushExpressHandler

 // 암호화 모드 WeChatService.messagePushExpressHandler (req: Request, res?: Response, resText?: string); // 일반 텍스트 모드 WeChatService.plainMessagePushExpressHandler (req: Request, res?: Response, resText?: string);

용법:

 @Post('push')asyncofficialPushTest (@Req() req: 요청, @Res() res: 응답) {
const decrypt = this.service.messagePushExpressHandler(req, res)를 기다립니다.}

위챗 애플릿

인터페이스 호출 자격 증명 받기

 public getAccessToken (appId?: 문자열, secret?: 문자열): Promise<AccessTokenResult>;

 const service = new WeChatService({ appId: '앱 ID', 비밀: '비밀'}); const res = wait service.mp.getAccessToken();console.log(res.data.access_token);

쿼리 제거 정보

 공용 비동기 getRid(rid: 문자열, accessToken: 문자열): Promise<RidInfo>;

플러그인 사용자 openpid 가져오기

 public async getPluginOpenPId (code: string, accessToken: string): Promise<DefaultRequestResult & { openpid: string }>;

code2Session에 로그인하세요.

 공개 비동기 code2Session(코드: 문자열, appId?: 문자열, 비밀?: 문자열): Promise<SessionResult>;

데이터 반환

 { "openid": "openid", "session_key": "key", "unionid": "unionid", "errcode": 0, "errmsg": "ok",
}

휴대폰 번호 받기

 공개 비동기 getPhoneNumber(코드: 문자열, accessToken: 문자열);

애플릿 코드 받기

 공개 비동기 getQRCode(매개변수: QRCode, accessToken: 문자열): Promise<DefaultRequestResult & { contentType: 문자열, 버퍼: Buffer }>;

무제한 미니 프로그램 코드 받기

 공개 getUnlimitedQRCode (매개변수: GetUnlimitedQRCode, accessToken: 문자열): Promise<DefaultRequestResult & { buffer: Buffer }>;

미니프로그램의 QR코드를 받아보세요

 공개 비동기 createQRCode(매개변수: CreateQRCode, accessToken: 문자열): Promise<DefaultRequestResult & { contentType: 문자열, 버퍼: Buffer }>;

쿼리 구성표 코드

 public async queryScheme (scheme: string, accessToken: string): Promise<DefaultRequestResult & {cheme_info: SchemeInfo,cheme_quota: SchemeQuota }>;

구성표 코드 받기

 공용 generateScheme(매개변수: 생성Scheme, accessToken: 문자열): Promise<DefaultRequestResult & { openlink: 문자열 >;

NFC 애플릿 구성표 가져오기

 공개 generateNFCScheme(매개변수: GenerationNFCScheme, accessToken: 문자열): Promise<DefaultRequestResult & { openlink: string }>;

URL링크 가져오기

 공개 generateUrlLink(매개변수: generateUrlLink, accessToken: 문자열): Promise<DefaultRequestResult & { url_link: string }>;

URL링크 쿼리

 public queryUrlLink(urlLink: 문자열, accessToken: 문자열): Promise<UrlLinkResult>;

GetShortLink

 public generateShortLink(매개변수: generateShortLink, accessToken: 문자열): Promise<DefaultRequestResult & { link: string }>;

통합 메시지 보내기

 공용 sendUniformMessage(매개변수: SendUniformMessage, accessToken: 문자열): Promise<DefaultRequestResult>;

활동_ID 생성

 공개 createActivityId(매개변수: CreateActivityId, accessToken: 문자열): Promise<ActivityIdResult>;

뉴스피드 편집

 공개 setUpdatableMsg(매개변수: UpdatableMsg, accessToken: 문자열): Promise<DefaultRequestResult>;

템플릿 삭제

 공개 deleteMessageTemplate(priTmplId: 문자열, accessToken: 문자열): Promise<DefaultRequestResult>;

카테고리 가져오기

 public getCategory (accessToken: string): Promise<DefaultRequestResult & { data: {id: number, name: string}[] }>;

키워드 목록 가져오기

 public getPubTemplateKeyWordsById (tid: 숫자, accessToken: 문자열): Promise<PubTemplateKeyWords>;

자신이 속한 카테고리 아래에서 공개 템플릿을 가져옵니다.

 공개 getPubTemplateTitleList(매개변수: PubTemplateTitleList, accessToken: 문자열): Promise<PubTemplateTitleListResult>;

개인 템플릿 목록 가져오기

 공용 getMessageTemplateList(accessToken: 문자열): Promise<MessageTemplateListResult>;

구독 메시지 보내기

 공개 sendMessage(매개변수: SendMessage, accessToken: 문자열): Promise<DefaultRequestResult>;

템플릿 추가

 공개 addMessageTemplate(매개변수: MessageTemplate, accessToken: 문자열): Promise<DefaultRequestResult & { priTmplId: string }>;

모바일 애플리케이션

모듈 가져오기

 import { 모듈 } from '@nestjs/common';import { WeChatMobileModule } from 'nest-wechat';@Module({
수입: [WeChatMobileModule.register()],})수출 클래스 AppModule {}

도구 소개

 import { MobileService } from 'nest-wechat';const service = new MobileService();

코드를 통해 access_token 얻기

 public getAccessToken(코드: 문자열, appId: 문자열, 비밀: 문자열): Promise<AxiosResponse<MobileAppAccessTokenResult, any>>;

access_token 새로 고침 또는 갱신

 public RefreshAccessToken (appId: 문자열, RefreshToken: 문자열): Promise<AxiosResponse<MobileAppAccessTokenResult, any>>;

access_token 확인

 public checkAccessToken (openId: 문자열, accessToken: 문자열): Promise<AxiosResponse<DefaultRequestResult, any>>;

위챗페이

미니 프로그램

JSAPI 주문

 pay.jsapi(주문: TransactionOrder, serialNo: 문자열, privateKey: Buffer | 문자열): Promise<{prepay_id: 문자열}>;

가맹점 주문번호 조회 주문

 pay.getTransactionById (id: 문자열, mchId: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열): Promise<Trade>;

WeChat 결제 주문 번호 조회 주문

 pay.getTransactionByOutTradeNo (outTradeNo: 문자열, mchId: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열): Promise<Trade>;

주문 마감

 pay.close (outTradeNo: 문자열, mchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

신청을 철회해주세요

 pay.refund (환불: RequireOnlyOne<RefundParameters, 'transaction_id' | 'out_trade_no'>, mchId: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열): Promise<RefundResult>;

단일 환불 쿼리

 pay.getRefund (outRefundNo: 문자열, mchId: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열): Promise<RefundResult>;

결제 매개변수를 호출하는 작은 프로그램을 구축하세요.

 pay.buildMiniProgramPayment(appId: 문자열, prepayId: 문자열, privateKey: Buffer | 문자열): MiniProgramPaymentParameters;

결제 알림 핸들러

 pay.paidCallback (publicKey: Buffer | string, apiKey: string, req: 요청, res: 응답): Promise<Trade>;

환불 알림 핸들러

 pay.refundedCallback (certs: Map<string, string>, apiKey: string, req: Request, res: Response): Promise<RefundNotifyResult>;

전자송장

개발 옵션 구성

 pay.fapiaoDevConfig(데이터: DevelopmentConfigRequest, mchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

판매자가 구성한 개발 옵션을 조회하세요.

 pay.getFapiaoDevConfig (mchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

전자송장, 카드, 쿠폰 템플릿 생성

 pay.createCardTemplate(데이터: CreateCardTemplateRequest, mchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

WeChat 청구서 알림

 pay.fapiaoCallback (certs: Map<string, string>, apiKey: string, req: Request, res: Response): Promise<FapiaoNotifyResult>;

사용자가 작성한 헤더 가져오기

 pay.getUserTitle(매개변수: GetUserTitleParams, mchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

전자계산서 발행

 pay.issueFapiao(데이터: IssueFapiaoRequest, mchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

전자송장 조회

 pay.getIssueFapiao (fapiaoApplyId: 문자열, fapiaoId: 문자열, mchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

빨간색 전자 송장

 pay.reverseFapiao (fapiaoApplyId: 문자열, 데이터: ReverseFapiaoRequest, mchId: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열);

민감한 정보 암호화 및 복호화

암호화

 pay.rsaEncryptOAEP(텍스트: 문자열, 공개 키: 버퍼 | 문자열);

해독

 pay.rsaDecryptOAEP(cipherText: 문자열, privateKey: 버퍼 | 문자열);

현금 빨간 봉투

사용 가능한 테스트 판매자가 없으며 테스트가 성공하지 못했습니다. 궁금한 사항이 있으면 문제를 제출해 주세요.

테스트는 자체적으로 단위 테스트를 실행할 수 있습니다(구성을 수정해야 함).

 npm 실행 테스트 lib/wepay.hb.spec.ts

빨간 봉투를 나눠주다

 pay.sendRedPack(redPack: RedPackData, appId: 문자열, mchId: 문자열, apiKey: 문자열, publicKey: Buffer | string, privateKey: Buffer | string, group = false): Promise<AxiosResponse<string, any>>;

핵분열 빨간 봉투 배포

 pay.sendGroupRedPack(redPack: GroupRedPackData, appId: 문자열, mchId: 문자열, apiKey: 문자열, publicKey: Buffer | string, privateKey: Buffer | string): Promise<AxiosResponse<string, any>>;

빨간 봉투 레코드 쿼리

 pay.getHbInfo(billNO: 문자열, appId: 문자열, mchId: 문자열, apiKey: 문자열, publicKey: Buffer | string, privateKey: Buffer | string): Promise<AxiosResponse<string, any>>;

위챗 결제 서비스 제공업체

서비스 제공자 JSAPI 주문

 jsapiOfPartner(순서: TransactionOrderOfPartner, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공자 JSAPI가 결제를 호출합니다.

WeChat 결제 매개변수 호출을 위한 인터페이스 구축

 buildJSAPIParameters(appId: 문자열, prepayId: 문자열, privateKey: Buffer | 문자열): MiniProgramPaymentParameters;

서비스 제공업체 결제 알림

 paidCallbackOfPartner(인증서: Map<string, string>, apiKey: 문자열, req: 요청, res: 응답): Promise<TradeOfPartner>;

서비스 제공업체가 주문을 종료함

 closeOfPartner (outTradeNo: 문자열, spMchId: 문자열, subMchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공자 WeChat 결제 주문 번호 조회 주문

 getTransactionByIdOfPartner(id: 문자열, spMchId: 문자열, subMchid: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공업체 가맹점 주문번호 조회 주문

 getTransactionByOutTradeNoOfPartner (outTradeNo: 문자열, spMchId: 문자열, subMchid: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열);

서비스 제공자 환불 신청

 RefundOfPartner(환불: RequireOnlyOne<RefundParametersOfPartner, 'transaction_id' | 'out_trade_no'>, spMchId: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열);

서비스 제공업체에서 단일 환불에 대해 문의합니다.

 getRefundOfPartner (outRefundNo: 문자열, spMchId: 문자열, subMchId: 문자열, serialNo: 문자열, privateKey: Buffer | 문자열);

서비스 제공자 환불 결과 알림

 환불된CallbackOfPartner(인증서: Map<string, string>, apiKey: 문자열, req: 요청, res: 응답): Promise<RefundNotifyResultOfPartner>;

서비스 제공업체 전자 청구서

서비스 제공업체는 전자 청구서, 카드, 쿠폰 템플릿을 생성합니다.

 createCardTemplateOfPartner(데이터: CreateCardTemplateRequestOfPartner, spMchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공업체 구성 개발 옵션

 fapiaoDevConfigOfPartner(데이터: DevelopmentConfigRequestOfPartner, spMchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공자는 판매자가 구성한 개발 옵션을 쿼리합니다.

 getFapiaoDevConfigOfPartner (spMchId: 문자열, subMchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공업체 WeChat 청구서 알림

 fapiaoCallbackOfPartner(인증서: Map<string, string>, apiKey: 문자열, req: 요청, res: 응답): Promise<FapiaoNotifyResultOfPartner>;

서비스 제공자는 사용자가 작성한 헤더를 얻습니다.

 getUserTitleOfPartner(매개변수: GetUserTitleParams, spMchId: 문자열, subMchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공업체가 전자 청구서를 발행합니다.

 issueFapiaoOfPartner(데이터: IssueFapiaoRequestOfPartner, spMchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열, platformSerial: 문자열);

서비스 제공자 조회 전자 청구서

 getIssueFapiaoOfPartner (fapiaoApplyId: 문자열, fapiaoId: 문자열 | null | 정의되지 않음, spMchId: 문자열, subMchid: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

서비스 제공업체 빨간색 전자 송장

 reverseFapiaoOfPartner(fapiaoApplyId: 문자열, 데이터: ReverseFapiaoRequestOfPartner, spMchId: 문자열, serialNo: 문자열, privateKey: 버퍼 | 문자열);

WeChat 결제 도구 기능

메시지 복호화

암호문 해독

 decryptCipherText<T> (apiKey: 문자열, 암호: 문자열, AssociatedData: 문자열, nonce: 문자열): T 문자열;

WeChat 메시지 암호화, 암호 해독 및 서명 도구

 import { MessageCrypto } from 'nest-wechat';const sha1 = MessageCrypto.sha1('string to hash');

정적 방법:

sha1 (...args: 문자열[]): 문자열;
md5(텍스트: 문자열): 문자열;
getAESKey(인코딩AESKey: 문자열): 버퍼;
getAESKeyIV(aesKey: 버퍼): 버퍼;
PKCS7Encoder(버프: 버퍼): 버퍼;
PKCS7Decoder(버프: 버퍼): 버퍼;
해독(aesKey: 버퍼, iv: 버퍼, str: 문자열): 문자열;
암호화(aesKey: 버퍼, iv: 버퍼, msg: 문자열, appId: 문자열): 문자열;
createNonceStr(길이 = 16): 문자열;
encryptMessage(appId: 문자열, 토큰: 문자열, 인코딩AESKey: 문자열, 메시지: 문자열, 타임스탬프: 문자열, nonce: 문자열): 문자열;
decryptMessage(토큰: 문자열, 인코딩AESKey: 문자열, 서명: 문자열, 타임스탬프: 문자열, nonce: 문자열, encryptXml: 문자열);
decryptMessage(토큰: 문자열, 인코딩AESKey: 문자열, 서명: 문자열, 타임스탬프: 문자열, nonce: 문자열, encryptXml: 문자열);
checkSignature(서명: 문자열, 타임스탬프: 문자열, nonce: 문자열, 토큰: 문자열);

테스트 실행

.env.test.local 파일을 생성하고 테스트 앱 ID와 비밀을 파일에 저장합니다.

TEST_APPID=your/test/appid
TEST_SECRET=your/test/secret
TEST_JSSDK_URL=https://your/website/url
TEST_TOKEN=your/token
TEST_AESKEY=your/aeskey

REDIS_HOST=your/redis/host
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0
REDIS_TTL=600

e2e 테스트를 실행합니다.

 npm 실행 테스트:e2e

단위 테스트를 실행합니다.

 npm 실행 테스트 wechat.service.userinfo.spec.ts

메시지 푸시 테스트

서비스 테스트 시작

 npx ts-node -T 테스트/e2e/wechat-app.main.ts

공개 계정 메시지 푸시 구성(WeChat 공개 테스트 플랫폼), 위 서비스 테스트를 활성화한 후 구성 확인을 통과할 수 있습니다.
URL: http://your/url/wechat/push, 예: http://113.22.11.2:3001/wechat/push
토큰: pamtest
WeChat 공개 플랫폼 인터페이스 디버깅 도구에서 access_token을 얻습니다.

몸

 { "grant_type": "client_credential",
"appid": "귀하의/appid",
"비밀": "귀하의/비밀",
"force_refresh": 거짓}

WeChat 개방형 플랫폼의 디버깅 도구 - 푸시 테스트를 위한 메시지 푸시 테스트용 디버깅 도구

확장하다

추가 정보

버전 0.2.50
유형 AI 소스 코드
업데이트 시간 2025-01-17
크기 310.19KB
출처 Github