Mailjet v3 API包装
mailjet-rest的Python项目详细描述
官方Mailjet Python包装器
API文档
所有代码示例都可以在Mailjet Documentation上找到。
(请参阅Mailjet Documentation Repository以提供文档示例)
安装
(sudo) pip install mailjet_rest
开始
获取api和密钥here。使用电子邮件API时,您需要它们进行身份验证:
exportMJ_APIKEY_PUBLIC='your api key'exportMJ_APIKEY_PRIVATE='your api secret'
API版本控制
MailJet API分布在三个不同的版本中:
v3
-电子邮件apiv3.1
-电子邮件发送api v3.1,这是我们发送api的最新版本v4
-sms api
由于大多数电子邮件api端点都位于v3
下,因此它被设置为默认端点,在发出请求时不需要指定。对于其他用户,您需要使用version
指定版本。例如,如果使用send api v3.1
:
# import the mailjet wrapperfrommailjet_restimportClientimportos# Get your environment Mailjet keysAPI_KEY=os.environ['MJ_APIKEY_PUBLIC']API_SECRET=os.environ['MJ_APIKEY_PRIVATE']# Initialize the client with API URL (default is 'https://api.eu.mailjet.com/')mailjet=Client(auth=(API_KEY,API_SECRET),version='v3',api_url='https://api.eu.mailjet.com/')
有关更多信息,请参阅我们的API Reference。
发出GET
请求:
# get all contactsresult=mailjet.contact.get()
GET
带有筛选器的请求:
# get the first 2 contactsresult=mailjet.contact.get(filters={'limit':2})
POST
请求
# Register a new sender email addressresult=mailjet.sender.create(data={'email':'test@mailjet.com'})
将资源与操作组合在一起
# Get the contacts lists of contact #2result=mailjet.contact_getcontactslists.get(id=2)
发送电子邮件
frommailjet_restimportClientimportosapi_key=os.environ['MJ_APIKEY_PUBLIC']api_secret=os.environ['MJ_APIKEY_PRIVATE']mailjet=Client(auth=(api_key,api_secret),version='v3.1')data={'Messages':[{"From":{"Email":"pilot@mailjet.com","Name":"Mailjet Pilot"},"To":[{"Email":"passenger1@mailjet.com","Name":"passenger 1"}],"Subject":"Your email flight plan!","TextPart":"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!","HTMLPart":"<h3>Dear passenger 1, welcome to Mailjet!</h3><br />May the delivery force be with you!"}]}result=mailjet.send.create(data=data)printresult.status_codeprintresult.json()
您还可以使用Mailjet的SendAPI(v3)的早期版本。您可以找到解释总体差异的文档和代码示例here。
创建新联系人
# wrapping the call inside a functiondefnew_contact(email):returnmailjet.contact.create(data={'Email':email})new_contact('mr@smith.com')