Newsman – Knowledge Base
Metoda API Newsman: subscriber.getSubscribersBatch
Prototip: subscriber.getSubscribersBatch(list_id, subscribers)
Descriere: Întoarce informațiile mai multor abonați după email sau subscriber_id
Metoda HTTP: GET
Endpoint HTTP: /subscriber.getSubscribersBatch.json
Endpoint XML-RPC: subscriber.getSubscribersBatch
Tip raspuns: ArrayInformatii raspuns: containing data for the found subscribers
Parametrii request GET
| Variabila | Tip | Descriere |
|---|---|---|
| list_id | string|int | ID-ul listei în care se află abonații pentru care se actualizează propietățile |
| subscribers | struct | Array conținând emailuri sau id-uri de abonați |
Parametrii raspuns
| Parametru | Descriere |
|---|---|
| boolean | Array conținând informațiile abonaților găsiți |
Exemplu output
[ { "list_id": "my_list_id", "subscriber_id": 75001, "email": "john.doe@example.com", "status": "subscribed", "subscription_type": "import", "subscribe_date": "2018-05-13 17:02:32", "firstname": null, "lastname": null, "ip": "127.0.0.1", "props": [], "segments": [ { "segment_id": 15002, "name": "my_segment_name" } ] } ]
Erori raspuns
| Cod | Mesaj | Descriere |
|---|---|---|
| 407 | Missing required param list_id | Parametrul list_id este obligatoriu |
| 407 | Missing required param subscribers | Parametrul subscribers este obligatoriu |
| 101 | Not allowed for list_id = %s | Acces nepermis la lista list_id |
| 129 | Not allowed for subscriber with ID: %s | Acces nepermis la abonat |
| 108 | List %s has been deleted | Lista a fost ștearsă |
Exemple de erori
{ "err": true, "message": "Missing required param list_id", "code": 407 }
{ "err": true, "message": "Missing required param subscribers", "code": 407 }
{ "err": true, "message": "Not allowed for subscriber with ID: 427001", "code": 129 }