Lists

פתח ב-Claudeפתח ב-ChatGPT.md

הוספת אנשי קשר

http
POST https://smsprovider-web.vercel.app/api/v1/lists/{id}/contacts

הוספה של עד 10,000 אנשי קשר; כפולים מתעדכנים.

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

פרמטרי נתיב

שדהסוג
idstring (uuid)

גוף הבקשה

שדהסוגחובההערות
contactsobject[]כןitems 1–10000

תשובה

200 — MutationResult

שגיאות

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

דוגמאות

curl

bash
curl -X POST "https://smsprovider-web.vercel.app/api/v1/lists/{id}/contacts" \
  -H "Authorization: Bearer $BATLER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contacts":[]}'

Node.js

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

const sms = new BatlerSMS({ apiKey: process.env.BATLER_API_KEY! });
const body = {
  "contacts": []
};
const result = await sms.lists.addContacts(id, body.contacts);

PHP

php
<?php
$ch = curl_init("https://smsprovider-web.vercel.app/api/v1/lists/{id}/contacts");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("BATLER_API_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode(["contacts" => []], JSON_UNESCAPED_UNICODE),
]);
$result = json_decode(curl_exec($ch), true);

Python

python
import os, uuid, requests

resp = requests.request(
    "POST", "https://smsprovider-web.vercel.app/api/v1/lists/{id}/contacts",
    headers={"Authorization": f"Bearer {os.environ['BATLER_API_KEY']}"},
    json={"contacts": []},
    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.Post, "https://smsprovider-web.vercel.app/api/v1/lists/{id}/contacts");
req.Content = new StringContent("{\"contacts\":[]}", System.Text.Encoding.UTF8, "application/json");
var res = await http.SendAsync(req);
var result = await res.Content.ReadAsStringAsync();
☰