Mesajele trimise prin sendEmail, nu cenzurat omul, astfel încât suma implicită permisă pentru a trimite mesaje prin această metodă pe zi este limitat la 1000 de utilizatori noi (și mai târziu pentru a limita performanța pozitivă a statisticilor de livrare va fi în mod automat mai mare), iar dimensiunea maximă a mesajului este limitată la 1 megabyte.
Întrucât mesajele pot fi făcute cât se poate de individual, nu există o substituție a câmpurilor în acestea, cu excepția valorii>.
Puteți afla starea livrării mesajului trimis utilizând metoda checkEmail. Pentru a accelera metoda sendEmail, starea livrării este stocată pentru o perioadă limitată de timp - doar o lună.
Principiu de utilizare
Sintaxă și adresă URL pentru a apela metoda
sendEmail (e-mail mixte, SENDER_NAME mixte, SENDER_EMAIL mixte, sub rezerva mixt, organism mixt, LIST_ID amestecat [, user_campaign_id mixte, atașamente mixte, amestecate lang, track_read mixte, track_links mixte, bool attach_multi, cc șir de caractere, matrice | antete șir, wrap_type șir, images_as coarde, bool error_checking, metadate amestecate])
Cheia de acces API
Puteți utiliza substituția ToName pentru a afișa numele destinatarului în câmpul Către clientul său de poștă electronică. Pentru a face acest lucru, puteți trece valoarea parametrului ca:
Textul scrisorii în format HTML. Câmpurile de substituire personalizate nu sunt aproape acceptate pentru o prelucrare mai rapidă (se presupune că scrisoarea este deja scrisă individual pentru destinatar) - disponibilitatea este garantată numai.
Textul poate include referințe relative la imagini stocate în folderul utilizatorului pe serverul nostru - astfel de imagini vor fi incluse în scrisoarea în sine. Legăturile cu imaginile de pe server ar trebui să arate astfel: "/ en / user_file? Resource = imagesname = IMAGE". unde în loc de IMAGE ar trebui să existe un nume de fișier din folderul dvs. de pe server, de exemplu image.jpg sau folder / image.jpg.
Dacă imaginea nu este stocată pe serverul nostru, puteți introduce imaginea, trecând-o ca fișier de atașament (a se vedea descrierea argumentului atașamentelor).
Dacă numărul elementelor din user_campaign_id este mai mic decât numărul elementelor din matricea de e-mail, user_campaign_id este atribuit numărului corespunzător al primelor elemente ale matricei de e-mailuri, rămânând literele rămase fără user_campaign_id.
Folosind scriptul PHP, conținutul fișierului poate fi obținut prin intermediul funcției file_get_contents. De exemplu: $ api_query = array ("Attachments [test.pdf]" => file_get_contents ('test.pdf'));
Se presupune că textul HTML conține numai conținutul etichetei corporale. Dacă transmiteți întregul text HTML, apoi testați aceste litere în plus - anteturile din afara corpului pot fi supuse unor modificări. În plus, pentru a reduce discrepanța în afișare în diferite programe de e-mail, adăugăm automat marcaj suplimentar la fiecare literă (tabelul cu margini invizibile, care stabilește, de asemenea, alinierea implicită a fontului și textului pe marginea din stânga). Puteți solicita să dezactivați acest lucru pentru e-mailurile dvs. prin contactarea asistenței tehnice sau setarea manuală a unei valori implicite la salvarea oricărui mesaj prin interfața web.
Codul de limbă în două litere pentru linia adăugată automat la fiecare literă cu linkul de dezabonare.
Dacă nu este specificat, se folosește codul de limbă din adresa URL API.
Pe lângă linia actuală cu referința de dezabonare, această limbă afectează și interfața paginii de dezabonare. Limbi acceptate integral ru. ua. ea și en. pentru mai multe alte limbi (da, de, es, fr, nl, pl, pt, tr) linkul va fi tradus, iar interfața de management va fi în limba engleză.
Text cu o listă de titluri, fiecare titlu pe o linie separată în format MIME. În timp ce sunt acceptate numai două titluri, Răspundeți-vă și Prioritate, restul va fi ignorat. exemplu:
Puneți textul HTML al literei într-un "înveliș" suplimentar din codul HTML pentru a îmbunătăți compatibilitatea cu diferite servicii de corespondență și pentru a alinia textul mesajului la o margine specificată. Dacă nu există nici un argument. atunci ambalajul se va face. De asemenea, parametrul poate avea valorile: săriți, dreapta, dreapta, stânga, centru.
Permite schimbarea modului de procesare a imaginilor imbricate într-o literă. Pot avea valori: atașamente (comportamentul implicit atunci când parametrul nu este definit) - imaginea va fi stocată în e-mail ca atașament, only_links - a trimis în cererea de imagine va fi stocată pe serviciul nostru, scrisoarea va fi, de asemenea afisate doar referiri la ele (acest lucru va reduce greutatea litere), user_default - se va utiliza unul dintre modurile de mai sus, instalat pentru un anumit utilizator de către serviciul de asistență sau reseller. Parametrul transmis în cerere are o prioritate mai mare decât cea stabilită pentru dvs. în profil.
Parametrul poate fi trecut de utilizator pentru a atribui o cheie de identificare literei. Valoarea cheie primită trebuie să fie unică.
Metadatele trimise în cerere sunt returnate Webhooks-ului.
meta1, meta2 (numărul maxim de taste este de 10, lungimea maximă a cheii este de 64 de caractere);
valoare1, valoare2 - valori cheie (lungimea maximă a valorii cheie este de 1024 caractere).
Exemplu de format nou pentru valoarea returnată: Rezultatul este returnat în acest format atunci când este apelat cu error_checking = 1 sau atunci când se utilizează sintaxa array pentru argumentul e-mail / când se utilizează argumentul cc. Valoarea returnată este o matrice de obiecte JSON (numărul de elemente este egal cu numărul de e-mail-uri trimise, inclusiv cc) cu următoarele câmpuri:
Un cod de mesaj unic este un șir de până la 64 de caractere.
Dacă eroarea este imposibilă din cauza unei erori, câmpul id lipsește. Totuși, este necesar să se ia în considerare faptul că nu toate erorile sunt dezvăluite la momentul primirii cererii de trimitere. În acest caz, mesajul este acceptat pentru procesare și primește un id, iar eroarea poate fi găsită mai târziu utilizând metoda checkEmail.
Lista codurilor de eroare posibile:
Codul unic al mesajului. Poate fi folosit pentru a controla livrarea metodei checkEmail.
Exemplu de generare a unei solicitări de adrese URL
Exemple PHP
Exemplu utilizând solicitarea POST
Trimiteți-le prietenilor: