Skip to main content

Email

Broadcast-uri email si gestionarea abonatilor. Toate endpoint-urile necesita autentificare.

GET /email/broadcasts​

Listeaza toate broadcast-urile.

curl https://api.paylinks.ro/api/v1/email/broadcasts \
  -H "Authorization: Bearer YOUR_TOKEN"

Raspuns (200):

[
  {
    "id": "bc-001",
    "subject": "New Product Launch",
    "body": "<h1>Exciting news!</h1>...",
    "status": "SENT",
    "recipientCount": 150,
    "sentAt": "2026-02-15T10:00:00.000Z",
    "createdAt": "2026-02-15T09:00:00.000Z"
  }
]

POST /email/broadcasts​

Creaza un nou broadcast (salvat ca ciorna).

curl -X POST https://api.paylinks.ro/api/v1/email/broadcasts \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "New Product Launch",
    "body": "<h1>Exciting news!</h1><p>We just launched a new course.</p>"
  }'

Corpul cererii:

CampTipObligatoriuDescriere
subjectstringDaSubiectul email-ului
bodystringDaCorpul email-ului in HTML

Raspuns (201): Obiectul broadcast cu status: "DRAFT".

GET /email/broadcasts/:id​

Obtine un singur broadcast.

curl https://api.paylinks.ro/api/v1/email/broadcasts/bc-001 \
  -H "Authorization: Bearer YOUR_TOKEN"

Raspuns (200): Obiectul complet al broadcast-ului.

POST /email/broadcasts/:id/send​

Trimite un broadcast catre toti abonatii.

curl -X POST https://api.paylinks.ro/api/v1/email/broadcasts/bc-001/send \
  -H "Authorization: Bearer YOUR_TOKEN"

Raspuns (200):

{
  "message": "Broadcast queued for sending",
  "recipientCount": 150
}

POST /email/broadcasts/ai-draft​

Genereaza un broadcast folosind AI.

curl -X POST https://api.paylinks.ro/api/v1/email/broadcasts/ai-draft \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Announce our new subscription plans starting at 29.99 RON/month"}'

Raspuns (200): Obiect broadcast cu subiect si corp generate de AI.

GET /email/subscribers​

Listeaza abonatii email.

curl "https://api.paylinks.ro/api/v1/email/subscribers?limit=50" \
  -H "Authorization: Bearer YOUR_TOKEN"

Raspuns (200):

{
  "data": [
    {
      "id": "sub-email-001",
      "email": "[email protected]",
      "name": "Maria Ionescu",
      "subscribedAt": "2026-01-10T10:00:00.000Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

POST /email/subscribers​

Adauga un singur abonat.

curl -X POST https://api.paylinks.ro/api/v1/email/subscribers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "name": "Ion"}'

Raspuns (201):

{"id": "sub-email-002", "email": "[email protected]"}

POST /email/subscribers/bulk​

Adauga mai multi abonati deodata.

curl -X POST https://api.paylinks.ro/api/v1/email/subscribers/bulk \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subscribers": [
      {"email": "[email protected]", "name": "Alice"},
      {"email": "[email protected]", "name": "Bob"}
    ]
  }'

Raspuns (200):

{"added": 2, "skipped": 0}

Valoarea skipped reprezinta abonatii care exista deja.