# Guidelines for Setting Up Mini Program User Privacy Protection

Debugging tools

Interface should be called on the server side, seeHattori API

# Interface Dxplaination

# Interface name

setPrivacySetting

# Functional description

  • This interface is used to configure user privacy protection guidelines for third-party generation development Mini Programs. Mini Program can be improved according to the actual situation. Mini Program is released to the C-side user show.

  • If you encounter problems during use, you canOpen Platform Service Provider ZonePosting exchanges

# Note

  1. After configuration, you need to resubmit the code audit, audit pass and need to be republished online before it will take effect on the Mini Program side.

  2. After configuration, it can be done byCheck the status of the latest submissionInterface queries the status of an audit and, if rejected, the reason for rejection.

3, pay attention to JSON when passing parameters_Encode Chinese into unicode encoding, otherwise in the Mini Program will be displayed as garbled. It is recommended that after the set is successful, adjust the get interface to see whether the set Chinese is displayed normally.

# Calling mode

# HTTPS call


POST https://api.weixin.qq.com/cgi-bin/component/setprivacysetting?access_token=ACCESS_TOKEN 

# Third Party Invocation

  • The calling method and parameters are the same as HTTPS, only the calling token is different

  • The permission set id to which this interface belongs is: 18

  • After the service provider has been authorized with one of the permission sets, it can do so by usingauthorizer_access_TokenCalling on behalf of the merchant

# Request parameters

attribute type RequiredIntroductions
access_Token string yes Interface invokes the certificate, which is URL Parameters, non Body Parameters. useauthorizer_access_Token
privacy_ver number no Version of the User Privacy Protection Guidelines, 1 indicates the current network version2 represents the development version. The default is 2 development version.
setting_list array no To configure the user information to be collected, you can choose the type of user information below for details. When privacy_When ver passes 2 or not, setting_List is requiredWhen privacy_When ver passes 1, the parameter cannot be passed, otherwise an error will be reported.
attribute type Required Introductions
privacy_key string yes The official optional values refer to the explaination belowThis field also supports customization. The same description applies to information collected by the sdk.
privacy_text string yes Please specify the purpose for which this information was collected. Such as privacy_Key = Location (location information), then privacy_Text fills in the purpose of collecting location information. There is no need to add "for" or "for" these words, the Mini Program display format is for xxx, so the developer only need to fill in the purpose directly. The same description applies to information collected by the SDK.
owner_setting object 初始值 Collector (Developer) Information Configuration
attribute type Required Introductions
contact_phone string no The phone number of the information collector (developer), and at least one of the four contact methods should be filled in
contact_email string no The email address of the information collector (developer) and at least one of the four contact methods
contact_qq string no The qq number of the information collector (developer), at least one of the four kinds of linkage methods should be filled in
contact_WeChat string no The WeChat account of the information collector (developer), at least one of the four contact methods should be filled in.
store_expire_timestamp string no The storage period refers to how long the developer collects user information and stores it. If you do not fill it in, it will be displayed as [the developer promises that, except as otherwise provided by laws and regulations, the developer shall keep your information for the shortest time necessary for the purpose of processing], if you fill in the number + days, such as "30 days," otherwise an error of 87072 will appear.
ext_file_media_id string no If the developer does not use the standardized user privacy protection guidelines provided by WeChat, you can also upload a self-defined user privacy protection guidelines, which can be uploaded through the uploadPrivacySetting interface to obtain media_id
Notice_method string yes Notification means that when the developer collects information changes, the user is notified through this method. Here the service provider needs to fill in according to the actual situation, such as through the pop-up window or announcement or other means.
store_region number no Storage area
sdk_privacy_info_list array no The Mini Program refers to the information of the third party sdk
attribute type Required Introductions
sdk_name string yes Name of SDK
sdk_biz_name string yes Principal name of the sdk provider
sdk_list array yes Information Collected by SDK and Its Use
attribute type Required Introductions
privacy_key string yes The official optional values refer to the explaination belowThis field also supports customization. The same description applies to information collected by the sdk.
privacy_text string yes Please specify the purpose for which this information was collected. Such as privacy_Key = Location (location information), then privacy_Text fills in the purpose of collecting location information. There is no need to add "for" or "for" these words, the Mini Program display format is for xxx, so the developer only need to fill in the purpose directly. The same description applies to information collected by the SDK.

# Return parameters

attribute type Introductions
errcode 初始值 Return code
errmsg string Error message

# Other Notes

# Supplementary explanation of parameters

1, the development version refers to the user privacy protection guide content that has been configured through the setprivacysetting interface, but has not been released to the current network, and has not been officially effective version.

2, the current network version refers to the user privacy protection guidelines that have already taken effect in the current network version of the Mini Program.

3, if the Mini Program has a current version, you can pass the interface (privacy_Ver = 1) directly modify the owner_Except for ext._file_media_Information other than ID can take effect after modification.

4, if you need to modify other information, you can only modify the development version (privacy)_Ver = 2), and then submit the code review, after the review is approved, the release takes effect.

  1. Privacy was passed on when the Mini Program did not yet have a current version of the privacy guidelines._Ver = 1, it will appear 86074 Reporting error

# privacy_key Optional values are as follows

  • The list may be added later, through the query Mini Program user privacy protection guide interface(getPrivacySetting)Get the latest information.
  • The Chinese description of the following list may be adjusted to query the Mini Program User Privacy Guidelines Interface(getPrivacySetting)Subject to acquisition
privacy_key privacy_desc
UserInfo User information (WeChat nickname, avatar)
Location Location information
Address address
Invoice Invoice Information
RunData WeRun campaign data
Record microphone
Album Selected photo or video information
Camera camera
PhoneNumber Phone number
Contact Address book (write only) permissions
DeviceInfo Equipment Information
EXIDNumber I.D. number
EXOrderInfo Order Information
EXUserPublishContent Publishing Content
EXUserFollowAcct Account number
EXUserOpLog Operation log
AlbumWriteOnly Album (Write Only) permission
LicensePlate License plate number
BlueTooth Bluetooth
CalendarWriteOnly Calendar (write only) permissions
Email mailbox
MessageFile Selected file
ChooseLocation Selected Location Information
Accelerometer Acceleration sensor
Compass Magnetic field sensor
DeviceMotion Direction sensor
Gyroscope Gyroscope sensor
Clipboard Sheared plate

# store_region Optional value

value meaning
1000 United Arab Emirates
1000 United Arab Emirates
1001 Antigua and Barbuda
1002 Angola
1003 Argentina
1004 Austria
1005 Australia
1006 Aruba
1007 Barbados
1008 Bermuda
1009 Brunei
1010 Brazil
1011 The Bahamas
1012 Bhutan
1013 Botswana
1014 Canada
1015 Democratic Republic of Congo
1016 Switzerland
1017 Chinese Mainland
1018 Germany
1019 Dominican republic
1020 Spain
1021 Fiji
1022 France
1023 Britain
1024 Grenada
1025 Georgia
初始值 Guernsey
1027 Gibraltar
1028 Greenland
1029 Gambia
1030 Guam
1031 Hong Kong, China
1032 Haiti
1033 Hungary
1034 Indonesia
1035 Ireland
1036 India
1037 Iraq
1038 Iran
1039 Iceland
1040 Italy
1041 Jersey
1042 Japan
1043 Cambodia
1044 Saint Kitts and Nevis
1045 The Republic of Korea
1046 Kuwait
1047 Cayman Islands
1048 Liechtenstein
1049 Libya
1050 Monaco
1051 Moldova
1052 Marshall Islands
1053 Macedonia
1054 Macau, China
1055 Northern Mariana Islands
1056 Mauritius
1057 Maldives
1058 Mexico
1059 Malaysia
1060 Mozambique
1061 New Caledonia
1062 Holland
1063 New Zealand
1064 Panama
1065 the Philippines
1066 Puerto Rico
1067 Portugal
1068 Republic of Palau or Belau
1069 Réunion
1070 Russia
1071 Saudi Arabia
1072 the Seychelles
1073 Sweden
1074 Singapore
1075 San Marino
1076 Swaziland
1077 Thailand
1078 Türkiye
1079 Trinidad and Tobago
1080 Taiwan, China
1081 Ukraine
1082 U.S.A
1083 Venezuela
1084 Vietnam
1085 Samoa
初始值 South Africa
初始值 Andorra
1088 Albania
1089 Armenia
1090 Azerbaijan
1091 Bangladesh
1092 初始值
1093 Bulgaria
1094 Barling
1095 Burundi
1096 Benin
1097 Bolivia
1098 初始值
1099 Chile
1100 Cameroon
1101 Columbia
1102 Costa Rica
1103 Servia
1104 Cuba
1105 Czech Republic
1106 Djibouti
1107 Denmark
1108 Algeria
1109 Ecuador
1110 Egypt
1111 Eritrea
1112 Ethiopia
1113 Finland
1114 Garner
1115 Greece
1116 Guatemala
1117 Honduras
1118 Croatia
1119 Israel
1120 Jamaica
1121 Jordan
1122 Kenya
1123 Kyrgyzstan
1124 Kiribati
1125 Korea
1126 Kazakhstan
1127 Laos
1128 Lebanon
1129 Sri Lanka
1130 Liberia
1131 Lesotho
1132 Luxemburg
1133 Latvia
1134 Morocco
1135 Madagascar
1136 Myanmar
初始值 Mongolia
1138 Mauritania
1139 Malawi
1140 Namibia
1141 Nigeria
1142 Nicaragua
初始值 Norway
1144 Nepal
1145 Oman
1146 Peru
1147 Papua New Guinea
1148 Pakistan
1149 Poland
1150 Qatar
1151 Romania
1152 Rwanda
1153 Solomon Islands in southwest Pacific
1154 Sudan
1155 Slovenia
1156 Slovakia
1157 Sierra Leone
1158 Senegal
1159 Suriname
1160 Tajikistan
1161 Tonga
1162 Tanzania
1163 Uganda
1164 Uruguay
1165 Uzbekistan
1166 Vanuatu in south pacific
1167 Yemen
1168 Zambia
2000 Afghanistan
2001 Åland Islands, Finland
2002 American Samoa
2003 Anguilla
2004 Antarctica
2005 Belarus
2006 Belize
2007 Bosnia and Herzegovina
2008 Bouvet Island
2009 British Indian Ocean Territory
2010 Burkina Faso
2011 Cape Verde
2012 Chad
2013 Christmas Island, Australia
2014 Cocos (Keeling) Islands
2015 Union of Comoros
2016 Congo (Brazzaville)
2017 Cook Islands
2018 Côte d'Ivoire
2019 Dominica
2020 Salvador
2021 Equatorial Guinea
2022 Falkland Islands (Malvinas)
2023 Faroe Islands
2024 French Guiana
2025 French Polynesia
2026 French Southern Territory
2027 Gabon
2028 Guadeloupe
2029 Guinea
2030 Guinea-Bissau
2031 Guianas
2032 Heard Island and McDonald Island
2033 Vatican City
2034 Isle of Man, British dependency
2035 Moray
2036 Martinique
2037 Mayotte
2038 Federated States of Micronesia
2039 Montenegro
2040 Montserrat
2041 Nauru
2042 Netherlands Antilles
2043 Niger
2044 Niue
2045 Norfolk Island
2046 Palestine
2047 Paraguay
2048 Pitcairn
2049 St Helena
2050 Saint Lucia
2051 Saint-Pierre and Miquelon
2052 Saint Vincent and the Grenadines
2053 Sao Tome and Principe
2054 Somalia
2055 South Georgia and Southern Sandwich Islands
2056 Svalbard and Jan Mayen
2057 Syria
2058 East Timor
2059 Togo
2060 Tokelau
2061 Tunisia
初始值 Turkmenistan
2063 Turks and Caicos Islands
2064 Tuvalu
2065 United States Minor Outlying Islands
2066 British Virgin Islands
2067 United States Virgin Islands
2068 Wallis and Futuna
2069 Western Sahara
2070 Zimbabwe
2071 Malta
2072 Cyprus
2073 Estonia
2074 Lithuania

# Call Example

Example Dxplaination: HTTPS requests

# Sample Request Data


{
    "owner_setting : {
       "contact_email" : "contact_email",
       "contact_phone" : "contact_email",
       "contact_qq " : "contact_qq " ,
       "contact_WeChat" : "contact_WeChat",
       "ext_file_media_id" : "2113706500236918784",
       "notice_method" : "notice_method",
       "store_expire_timestamp" : "store_expire_timestamp"
    },
    "setting_list" : [
       {
          "privacy_key" : "privacy_key",
          "privacy_text" : "privacy_text"
       },
       {
          "privacy_key" : "privacy_key",
          "privacy_text" : "privacy_text"
       }
    ],
    "sdk_privacy_info_list":[
        {
            "sdk_name":"测试sdk",
            "sdk_biz_Name ":" Wheat Limited Company, "
            "sdk_list":[
                {
                    "privacy_Key ":" avatar information, "
                    "privacy_Text ":" Use it to show your beauty "
                }
                
            ]
        }
    ],
    "privacy_see:2,
 } 

# Return Data Example


{"errcode": 0,
  "errmsg":"ok"
  } 

# Error code

Error code Error code Solutions
0 ok ok
86069 owner_Setting Required Field Field Missing
86070 Notice_Method Required Field Field Missing
86072 store_expire_The timestamp parameter is invalid. If the encoding format is wrong, this error will also be reported
初始值 ext_file_media_Invalid id parameter
86074 This Privacy Policy does not exist.
86075 Privacy Agreement Privacy Policy_file_media_id prohibited modification