위 챗 공공 플랫폼 개발 튜 토리 얼(2)기본 원리 와 정보 인터페이스 총화

기본 원리
시작 하기 전에 모두 가 이것 에 대해 매우 흥 미 를 느 낄 수 있 지만,비교적 막연 하 다.복잡 하 죠?배우 기 힘 든 데?
사실은 정반 대로 간단 하 다.여러분 의 우려 를 불식 시 키 기 위해 먼저 위 챗 공식 플랫폼 의 기본 원 리 를 간단하게 소개 하 였 습 니 다.
위 챗 서버 는 하나의 퍼 가기 서버 에 해당 합 니 다.단말기(핸드폰,Pad 등)가 위 챗 서버,위 챗 서버 에 요청 한 다음 에 사용자 정의 서비스 에 퍼 가기 요청 을 합 니 다(이것 이 바로 우리 의 구체 적 인 실현 입 니 다).
서비스 처리 가 끝 난 후에 위 챗 서버 에 휘발 하고 위 챗 서버 는 구체 적 인 응답 을 터미널 에 답장 합 니 다.
통신 프로 토 콜:HTTP
데이터 형식:XML
구체 적 인 절 차 는 다음 그림 과 같다.

사실 우리 가 해 야 할 일 은 HTTP 요청 에 응답 하 는 것 이다.
구체 적 인 요청 내용 은 특정한 XML 형식 으로 해석 하고 처리 가 끝 난 후에 도 특정한 XML 형식 으로 되 돌아 가 야 합 니 다.
우 리 는 HttpHandler 를 간단하게 실현 하면 된다.
물론 위 챗 플랫폼 은 더욱 복잡 한 업 무 를 실현 할 수 있다.예 를 들 어 위 챗 은 내 장 된 브 라 우 저 로 서 우 리 는 위 챗 의 링크 를 통 해 htm 인터페이스 를 열 고 자신의 논 리 를 실현 할 수 있다.
 2.메시지 인터페이스(공식 문서)
신청 메시지 인터페이스
신청 하 다. 을 누 르 면 사이트 URL url 과 token 을 작성 합 니 다.그 중에서 token 은 개발 자가 임의로 작성 하여 서명 을 만 들 수 있 습 니 다.
인터넷 주소 접속
공공 플랫폼 사용자 가 정 보 를 제출 하면 위 챗 서버 는 GET 요청 을 작성 한 URL 에 보 내 고 네 개의 인 자 를 가 져 옵 니 다.
매개 변수
묘사 하 다.
signature
위 챗 암호 화 서명
timestamp
타임 스탬프
nonce
난수
echostr
무 작위 문자열
개발 자 는 signature 검 사 를 통 해 요청 을 검증 합 니 다(아래 에 검증 방식 이 있 습 니 다).이번 GET 요청 이 위 챗 서버 에서 온 것 을 확인 하면 echostr 매개 변수 내용 을 그대로 되 돌려 주 십시오.그렇지 않 으 면 접속 이 실 패 했 습 니 다.
signature 는 개발 자가 작성 한 token 매개 변수 와 요청 한 timestamp 매개 변수,nonce 매개 변 수 를 결합 시 켰 습 니 다.
암호 화/검사 절차:
1.token,timestamp,nonce 세 개의 매개 변 수 를 사전 순서 로 정렬 합 니 다.
2.세 개의 매개 변수 문자열 을 하나의 문자열 로 연결 하여 sha 1 암호 화
3.개발 자가 암호 화 된 문자열 을 받 으 면 signature 와 비교 할 수 있 습 니 다.이 요청 은 위 챗 에서 기원 되 었 음 을 표시 합 니 다. 
메시지 푸 시
일반 위 챗 사용자 가 공식 계 정 에 메 시 지 를 보 낼 때 위 챗 서버 는 이 메 시 지 를 작성 한 URL 에 POST 를 보 냅 니 다.구 조 는 다음 과 같다.
텍스트 메시지

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName> 
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[this is a test]]></Content>
 <MsgId>1234567890123456</MsgId>
 </xml>

매개 변수
묘사 하 다.
ToUserName
개발 자 마이크로 신호
FromUserName
발신 자 계 정(OpenID 하나)
CreateTime
메시지 생 성 시간(정형)
MsgType
text
Content
텍스트 메시지 내용
MsgId
메시지 id,64 비트 정형
그림 메시지

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[image]]></MsgType>
 <PicUrl><![CDATA[this is a url]]></PicUrl>
 <MsgId>1234567890123456</MsgId>
 </xml>

매개 변수
묘사 하 다.
ToUserName
개발 자 마이크로 신호
FromUserName
발신 자 계 정(OpenID 하나)
CreateTime
메시지 생 성 시간(정형)
MsgType
image
PicUrl
그림 링크
MsgId
메시지 id,64 비트 정형
지리 적 위치 정보

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>23.134521</Location_X>
<Location_Y>113.358803</Location_Y>
<Scale>20</Scale>
<Label><![CDATA[    ]]></Label>
<MsgId>1234567890123456</MsgId>
</xml>

매개 변수
묘사 하 다.
ToUserName
개발 자 마이크로 신호
FromUserName
발신 자 계 정(OpenID 하나)
CreateTime
메시지 생 성 시간(정형)
MsgType
location
Location_X
위도
Location_Y
지리 적 위치 경도
Scale
지도 크기 조정
Label
지리 적 위치 정보
MsgId
메시지 id,64 비트 정형
링크 메시지

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[        ]]></Title>
<Description><![CDATA[        ]]></Description>
<Url><![CDATA[url]]></Url>
<MsgId>1234567890123456</MsgId>
</xml>

매개 변수
묘사 하 다.
ToUserName
수신 자 마이크로 신호
FromUserName
일반 사용 자 를 위 한 마이크로 신 호 를 보 내 면 OpenID 입 니 다.
CreateTime
메시지 생 성 시간
MsgType
메시지 형식,링크
Title
메시지 제목
Description
메시지 설명
Url
메시지 링크
MsgId
메시지 id,64 비트 정형
이벤트 푸 시
이벤트 푸 시 는 위 챗 4.5 버 전 만 지원 합 니 다.현재 사용자 정의 메뉴 인터페이스 이벤트 푸 시,관심 및 취소 이벤트 푸 시 를 시작 합 니 다.나머지 기능 은 곧 개 방 될 예정 이 니 기대 해 주시 기 바 랍 니 다.

<xml><ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[FromUser]]></FromUserName>
<CreateTime>123456789</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[EVENT]]></Event>
<EventKey><![CDATA[EVENTKEY]]></EventKey>
</xml>

매개 변수
묘사 하 다.
ToUserName
수신 자 마이크로 신호
FromUserName
일반 사용 자 를 위 한 마이크로 신 호 를 보 내 면 OpenID 입 니 다.
CreateTime
메시지 생 성 시간
MsgType
메시지 형식,이벤트
Event
이벤트 유형,구독(구독),구독 취소(구독 취소),클릭(사용자 정의 메뉴 클릭 이벤트)
EventKey
이벤트 KEY 값,사용자 정의 메뉴 인터페이스 에서 KEY 값 과 대응
소식
모든 POST 요청 에 대해 개발 자 는 응답 패키지 에서 특정한 xml 구 조 를 되 돌려 이 메시지 에 응답 합 니 다(현재 답장 텍스트,그림,음성,영상,음악 지원).
위 챗 서버 가 5 초 안에 응답 을 받 지 못 하면 연결 이 끊 깁 니 다.
xml 구 조 는 다음 과 같 습 니 다.
답장 메시지

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[content]]></Content>
 </xml>

매개 변수
묘사 하 다.
ToUserName
수신 자 계 정(받 은 OpenID)
FromUserName
개발 자 마이크로 신호
CreateTime
메시지 생 성 시간
MsgType
text
Content
답장 메시지 내용,길이 2048 바이트 초과 하지 않 음
음악

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[music]]></MsgType>
 <Music>
 <Title><![CDATA[TITLE]]></Title>
 <Description><![CDATA[DESCRIPTION]]></Description>
 <MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
 <HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
 </Music>
 </xml>

매개 변수
묘사 하 다.
ToUserName
수신 자 계 정(받 은 OpenID)
FromUserName
개발 자 마이크로 신호
CreateTime
메시지 생 성 시간
MsgType
music
MusicUrl
음악 링크
HQMusicUrl
고 품질 음악 링크,와 이 파이 환경 우선 이 링크 로 음악 재생
그림 메시지

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[news]]></MsgType>
 <ArticleCount>2</ArticleCount>
 <Articles>
 <item>
 <Title><![CDATA[title1]]></Title> 
 <Description><![CDATA[description1]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 <item>
 <Title><![CDATA[title]]></Title>
 <Description><![CDATA[description]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 </Articles>
 </xml>

매개 변수
묘사 하 다.
ToUserName
수신 자 계 정(받 은 OpenID)
FromUserName
개발 자 마이크로 신호
CreateTime
메시지 생 성 시간
MsgType
news
ArticleCount
그림 메시지 개 수 를 10 개 이내 로 제한 합 니 다.
Articles
여러 개의 그림 메시지 정보,기본 첫 번 째 아 이 템 은 큰 그림 입 니 다.
Title
그림 메시지 제목
Description
그림 메시지 설명
PicUrl
JPG,PNG 형식 을 지원 하 는 이미지 링크 로 큰 그림 640*320,작은 그림 80*80 효과 가 좋 습 니 다.
Url
그림 메시지 점프 링크 클릭
공식 인터페이스 문서:http://mp.weixin.qq.com/wiki/index.php?title=%E6%B6%88%E6%81%AF%E6%8E%A5%E5%8F%A3%E6%8C%87%E5%8D%97
주의 사항
1.사용자 OpenID 는 일반 번호 에 대한 유일한 문자열 입 니 다.
2.80 포트 사용
앞으로 구체 적 인 개발 과정 을 전면적으로 설명 하 겠 습 니 다.
3.소식 유형 도

이상 이 바로 본 고의 모든 내용 입 니 다.여러분 의 학습 에 도움 이 되 고 저 희 를 많이 응원 해 주 셨 으 면 좋 겠 습 니 다.