רשימת הודעות

http

GET https://smsprovider-web.vercel.app/api/v1/messages

רשימה מסוננת לפי סטטוס, טווח תאריכים, קמפיין או טלפון. Pagination עם cursor.

אימות: Authorization: Bearer bm_live_… · Scope נדרש: reports

פרמטרי שאילתה

שדה	סוג	חובה	הערות
`limit`	integer	לא	1–1000, default `100`
`cursor`	string	לא	len 0–200
`status`	`queued` \| `sent` \| `delivered` \| `failed` \| `expired` \| `cancelled`	לא
`from`	string (date-time)	לא
`to`	string (date-time)	לא
`campaign_id`	string (uuid)	לא
`phone`	string	לא	len 5–20

תשובה

200 — MessagePage

שגיאות

סטטוס	קוד
400	`validation_error`
401	`unauthorized`
403	`insufficient_scope`
429	`rate_limited`
500	`internal_error`

דוגמאות

curl

bash

curl -X GET "https://smsprovider-web.vercel.app/api/v1/messages?status=delivered&limit=100" \
  -H "Authorization: Bearer $BATLER_API_KEY"

Node.js

import { BatlerSMS } from "@batler/sms";

const sms = new BatlerSMS({ apiKey: process.env.BATLER_API_KEY! });
const result = await sms.messages.list({ status: "delivered" });

PHP

php

<?php
$ch = curl_init("https://smsprovider-web.vercel.app/api/v1/messages?status=delivered&limit=100");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("BATLER_API_KEY"),
    "Content-Type: application/json",
  ],
]);
$result = json_decode(curl_exec($ch), true);

Python

python

import os, uuid, requests

resp = requests.request(
    "GET", "https://smsprovider-web.vercel.app/api/v1/messages?status=delivered&limit=100",
    headers={"Authorization": f"Bearer {os.environ['BATLER_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
result = resp.json()

C#

csharp

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new("Bearer", Environment.GetEnvironmentVariable("BATLER_API_KEY"));
var req = new HttpRequestMessage(HttpMethod.Get, "https://smsprovider-web.vercel.app/api/v1/messages?status=delivered&limit=100");
var res = await http.SendAsync(req);
var result = await res.Content.ReadAsStringAsync();