개발자는 때때로 일부 자료를 영구적으로 저장해야 합니다. 이 인터페이스를 통해 재료를 추가할 수 있습니다.
최근 업데이트된 영구 이미지 자료가 추가된 후 개발자는 URL을 Tencent 도메인 이름 내에서 사용할 수 있습니다(Tencent 도메인 이름 외부에서 사용하는 경우). , 이미지는 방패가 됩니다).
참고:
1 새로 추가된 영구 자료는 공개 플랫폼 #🎜🎜 공식 웹 사이트의 자료 관리 모듈에서도 볼 수 있습니다. #
2. 영구재료 갯수에는 상한이 있으니 새로 추가하실때 주의해주세요. 그래픽 메시지 자료 및 그림 자료의 상한은 5000개, 기타 유형은 1000개입니다
3 자료의 형식과 크기는 공개 플랫폼의 공식 웹사이트와 일치합니다. 구체적으로 이미지 크기는 2M 이하, bmp/png/jpeg/jpg/gif 형식 지원, 음성 크기는 5M 이하, 길이는 60초 이하, mp3/wma/wav/amr 형식 지원 #🎜 🎜#
4. 이 인터페이스를 호출하려면 https 프로토콜이 필요합니다
새로운 영구 그래픽 소재
인터페이스 호출 요청 설명
http 요청 방법: POST
https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN
#🎜 🎜# 전화 예시
{
"articles": [{
"title": TITLE,# 🎜🎜 #
"thumb_media_id": THUMB_MEDIA_ID,
"작성자": AUTHOR,
"digest": DIGEST,#🎜 🎜#
“ show_cover_pic" : SHOW_COVER_PIC(0 / 1),
"content": CONTENT,
"content_source_url": CONTENT_SOURCE_URL
},#🎜🎜 ## 🎜🎜# //새 자료가 여러 개의 그림과 텍스트인 경우 여기에 여러 기사 구조가 있어야 합니다
]
}
# 🎜🎜#
매개변수 설명
Parameter | 필수인가요 | 설명 |
# 🎜 🎜#제목 | 은 | title | #🎜🎜 # # 🎜🎜#
thumb_media_id는 | 그래픽 메시지의 표지 사진 자료 ID입니다(영구적인 mediaID여야 합니다). |
author | 은 | author |
digest입니다. | 는 | 문자 메시지 요약입니다. 단일 이미지와 문자 메시지에만 초록이 있습니다. 여기에는 여러 이미지와 문자 메시지가 비어 있습니다. | 은 | 표지 표시 여부, 0은 false, 즉 표시되지 않음, 1은 true, 즉 표시됨 # 🎜🎜##🎜🎜 # |
content은 | #의 특정 콘텐츠입니다. 🎜🎜# 그래픽 메시지, HTML 태그 지원, 20,000자 미만, 1M 미만이어야 하며 여기서 JS는 제거됩니다. 🎜🎜#은 그래픽 메시지의 원래 주소 | #🎜🎜 #, "원본 읽기"를 클릭한 후의 URL |
#🎜 🎜#반환 지침
{
"media_id":MEDIA_ID
}
반환되는 것은 새로 추가된 그래픽 메시지 자료의 media_id입니다.
그래픽 메시지의 특정 콘텐츠에서 외부 이미지 링크가 필터링된다는 점에 유의하세요. 개발자는 다음 인터페이스를 통해 이미지를 업로드하여 URL을 얻고 이를 그래픽 콘텐츠에 넣어 사용할 수 있습니다.
URL을 얻으려면 그래픽 메시지에 있는 사진을 업로드하세요 이 인터페이스로 업로드된 사진은 공개 계정의 자료 라이브러리에 있는 사진 수 제한인 5000개를 차지하지 않습니다. 이미지는 jpg/png 형식만 지원하며 크기는 1MB 미만이어야 합니다.
인터페이스 호출 요청 설명
http 요청 방법: POST
https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
호출 예시(curl 명령어 사용, FORM 양식을 사용하여 이미지 업로드):
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"
매개변수 설명
매개변수 | 가 필수인가요? | 설명 |
access_token | 은 | 호출 인터페이스 자격 증명 |
입니다. 미디어 | 은 | form-데이터 미디어 파일 식별(파일 이름, 파일 길이, 콘텐츠 유형 및 기타 정보 포함)#🎜🎜 # |
반품 지침 일반적인 상황에서의 반품 결과는 다음과 같습니다.
{
"url": "http: //mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}
#🎜 🎜#
URL은 업로드된 이미지의 URL로, 이후 그룹 전송에 사용되거나 그래픽 메시지에 배치될 수 있습니다.
다른 유형의 영구 재료 추가
인터페이스 호출 요청 지침
인터페이스는 POST 양식을 통해 호출됩니다. 양식 ID는 미디어이며 파일 이름, 파일 길이, 콘텐츠 유형 및 기타 정보를 포함하여 업로드해야 하는 자료 콘텐츠를 포함합니다. 참고: 사진 자료는 공개 플랫폼 공식 웹사이트 자료 관리 모듈의 기본 그룹에 들어갑니다.
http 요청 방법: POST, https
https://api.weixin.qq.com/cgi-bin/material/add_material을 사용해야 합니까? access_token =ACCESS_TOKEN&type=TYPE
Call 예시 (FORM 형식을 사용하여 다른 유형의 영구 소재를 추가하려면 컬 명령어를 사용하세요. 컬 명령어 사용 정보를 참고해주세요)
매개변수 설명
매개변수 | 가 필수인가요? | 설명 |
access_token | 예 | 调用接口凭证 |
type | 是 | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb) |
media | 은 | form-데이터 미디어 파일 식별(파일 이름, 파일 길이, 콘텐츠 유형 및 기타 정보 포함)#🎜🎜 # |
영구적인 영상 자료 추가 시 특별한 주의가 필요합니다
영상 자료를 업로드할 때 자료의 설명 정보가 포함된 설명 ID를 가진 다른 양식을 게시해야 합니다. 형식은 JSON이고 형식은 다음과 같습니다. # 🎜🎜#
{ "title":VIDEO_TITLE,
"introduction":INTRODUCTION
}
#🎜🎜 #새로운 영구 영상 자료 호출 예시:# 🎜🎜#
curl "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE" -F media=@ media.file -F 설명='{" 제목":VIDEO_TITLE, "소개":소개}'매개변수 설명
Parameter | 필요합니까 | Description#🎜🎜 # |
title | 은 | 동영상 자료의 제목입니다 |
#🎜 🎜# 소개는 | 동영상 자료 | |
에 대한 설명입니다.반환 설명
{
"media_id":MEDIA_ID,
"url":URL
}
반환 매개변수 설명
매개변수 | description |
media_id#🎜 🎜 # | 새 영구 소재의 media_id |
url | 새 사진 소재의 사진 URL(새 사진만 해당) 필드는 재료 사용시 반환됩니다) |
오류 조건에서 반환된 JSON 데이터 패킷의 예는 다음과 같습니다(예는 잘못된 미디어 유형 오류입니다):
{"errcode":40007,"errmsg":"invalid media_id"}