API Reference

The SDKs wrap the public PING8 Send API routes.

Base URL

Default:

https://mail.gitdate.ink

Accepted:

https://mail.gitdate.ink
https://mail.gitdate.ink/api

Both resolve to /api/batch_mail/api/....

POST /api/batch_mail/api/send
X-API-Key: YOUR_API_KEY
Content-Type: application/json

Request:

{
  "recipient": "user@example.com",
  "addresser": "noreply@example.com",
  "attribs": {
    "first_name": "Ada"
  }
}

addresser and attribs are optional.

POST /api/batch_mail/api/batch_send
X-API-Key: YOUR_API_KEY
Content-Type: application/json

Request:

{
  "recipients": ["ada@example.com", "grace@example.com"],
  "addresser": "noreply@example.com",
  "attribs": {
    "campaign": "launch"
  }
}

PING8 responses use the standard server envelope:

{
  "success": true,
  "code": 0,
  "msg": "success",
  "data": {}
}

SDK result models tolerate missing or nullable response fields and convert them into safe defaults.

Field	Meaning
`accepted`	Request was accepted for queueing
`status`	SDK/API status text
`api_log_id`	API log row identifier
`message_id`	Engine/provider message identifier when available
`engine`	Selected delivery engine
`injection_status`	Injection lifecycle state
`delivery_status`	Delivery lifecycle state

Batch sends return accepted, status, message_ids, engine, injection_status, and delivery_status.