API დოკუმენტაცია

sendsms.ge API საშუალებას გაძლევს გააგზავნო SMS, შეამოწმო სტატუსი და ბალანსი პირდაპირ შენი სისტემიდან. ყველა მოთხოვნა HTTPS-ით; პასუხი — JSON.

ავტორიზაცია

ყველა მოთხოვნა მოითხოვს key პარამეტრს — შენი ანგარიშის API გასაღებს. გადააწოდე query-ში ან POST body-ში.

https://sendsms.ge/api/v2/send

პარამეტრები

მაგალითი

curl "https://sendsms.ge/api/v2/send?key=YOUR_API_KEY\
&sender=MyShop\
&destination=995599123456,995577654321\
&content=Hello%20World"

<?php
$query = http_build_query([
    'key'         => 'YOUR_API_KEY',
    'sender'      => 'MyShop',
    'destination' => '995599123456',
    'content'     => 'Hello World',
]);
$response = file_get_contents("https://sendsms.ge/api/v2/send?$query");
$data = json_decode($response, true);
var_dump($data);

import requests

r = requests.get("https://sendsms.ge/api/v2/send", params={
    "key": "YOUR_API_KEY",
    "sender": "MyShop",
    "destination": "995599123456",
    "content": "Hello World",
})
print(r.json())

const params = new URLSearchParams({
  key: "YOUR_API_KEY",
  sender: "MyShop",
  destination: "995599123456",
  content: "Hello World",
});
const res = await fetch(`https://sendsms.ge/api/v2/send?${params}`);
console.log(await res.json());

პასუხი

{
  "Success": true,
  "Message": "Accepted for delivery",
  "Output": {
    "smsID": "123456",
    "sent": 2,
    "segments": 1,
    "cost": 2,
    "invalid": []
  },
  "ErrorCode": 0
}

{
  "Success": false,
  "Message": "Insufficient balance",
  "Output": null,
  "ErrorCode": 20
}

https://sendsms.ge/api/v2/getMessageStatus

სტატუსს შენ გვეკითხები — ჩვენ არაფერს გიგზავნით და შენი მხრიდან endpoint-ის აწყობა არ სჭირდება.

key და destination — სავალდებულო; reference — არასავალდებულო. თუ reference-ს არ მიუთითებ, პასუხი ამ ნომერზე ბოლოს გაგზავნილ შეტყობინებას ეხება. ნომერი ნებისმიერი ჩვეული ფორმატით მიიღება — 995599123456, +995 599 12 34 56 თუ 599123456.

curl "https://sendsms.ge/api/v2/getMessageStatus?key=YOUR_API_KEY&destination=995599123456&reference=order-42"

→ {
  "Success": true,
  "Output": {
    "Status": "Delivered",
    "DeliveredAt": "2026-07-25T22:03:11+04:00",
    "DeliveredAtUnix": 1785002591
  },
  "ErrorCode": 0
}

მოთხოვნების ლიმიტი

წუთში 60 მოთხოვნა — ცალკე ითვლება თითოეულ გასაღებზე და თითოეულ endpoint-ზე. ანუ გაგზავნას თავისი 60 აქვს, სტატუსის შემოწმებას — თავისი: შენივე შემოწმება გაგზავნას ვერ დაგიბლოკავს.

ერთ მოთხოვნაში მრავალი ნომერი ერთ მოთხოვნად ითვლება — ამიტომ მასობრივი გაგზავნისას ნომრები მძიმით გამოყავი, თითოზე ცალკე ზარის ნაცვლად.

ლიმიტის გადაჭარბებისას HTTP 429 დაბრუნდება — იმავე ფორმით, რაც ყველა სხვა პასუხს აქვს:

{
  "Success": false,
  "Message": "Too many requests, retry in 37 seconds",
  "Output": null,
  "ErrorCode": 429
}

429 არ ნიშნავს, რომ SMS არ გაიგზავნა — ის ნიშნავს, რომ მოთხოვნა საერთოდ არ მიგვიღია. უსაფრთხოდ გაიმეორე Retry-After-ის შემდეგ.

https://sendsms.ge/api/getBalance

curl "https://sendsms.ge/api/getBalance?key=YOUR_API_KEY"

→ 4520

აბრუნებს დარჩენილი SMS-ების რაოდენობას (რიცხვი).

Delivery reports (Callback)

მიუთითე Callback URL API გვერდზე და გააგზავნე SMS reference-ით. სტატუსის შეცვლისას გამოგიგზავნით GET მოთხოვნას — პარამეტრები query string-შია, სხეული ცარიელია:

GET https://your-server.ge/callback?reference=order-42&status=Delivered
    &reason=&destination=995599123456×tamp=20260613184500&operator=

პარამეტრები

status -ის შესაძლო მნიშვნელობები

Delivered, Undelivered, Expired, Pending, Unknown — სხვა სიტყვა არ იგზავნება. თუ უცნობი მნიშვნელობა მიიღე, ნუ ჩათვლი მიწოდებულად.

SMS დათვლა

ხარჯი = სეგმენტების რაოდენობა × მიმღები ნომრების რაოდენობა.

შეცდომის კოდები