SENDER CORE · API V1

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

ინტეგრაციის სრული ტექნიკური გზამკვლევი — პირველი მოთხოვნიდან SMS-ის საბოლოო მიწოდებამდე.

ინტეგრაციის დაწყება OpenAPI JSON

განახლდა 22.08.2026

OUTBOUND · HTTPSPOST /send.phprequest accepted

MESSAGE QUEUESubmittedmessageId created

ROUTING ENGINESender CoreROUTE · VALIDATE · DISPATCHMT ↔ MO

OPERATOR GATEWAYRoutingcarrier handoff

HANDSETDeliveredstatusId: 1

INBOUND · DLRDelivery Receiptcallback.php

Submitted00.18s Routing00.42s Delivered00.81s DLR received00.86s

DEMO MESSAGE FLOWREQ #SG-8F21 · DEMO

GET STARTED

პირველი SMS — 3 ნაბიჯში

მიიღეთ API გასაღები, გააგზავნეთ უსაფრთხო POST მოთხოვნა და შეინახეთ მიღებული messageId მიწოდების სტატუსის სანახავად.

API გასაღები

ავტორიზაციის შემდეგ მიიღეთ უნიკალური გასაღები Sender.ge-ის პროფილიდან.

POST მოთხოვნა

მონაცემები გააგზავნეთ URL-encoded request body-ში და არა მისამართის query-ში.

Delivery Status

პასუხიდან მიღებული messageId-ით გადაამოწმეთ საბოლოო სტატუსი.

quick-start.sh

curl -X POST "https://sender.ge/api/send.php" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  --data-urlencode "smsno=1" \
  --data-urlencode "destination=555123456" \
  --data-urlencode "content=Hello"

სრული მაგალითი

ინტეგრაციის სამუშაო სივრცე

კოდის მაგალითები

აირჩიეთ ენა, API ოპერაცია, HTTP მეთოდი და მაგალითის დონე — კოდი განახლდება ენის შესაბამისი კომენტარებით, პარამეტრების აღწერითა და პასუხის კოდებით.

7პროგრამირების ენა

ოპერაცია

HTTP მეთოდი

მაგალითი

POST https://sender.ge/api/send.php

Production-ისთვის რეკომენდებული API გასაღები და მოთხოვნის მონაცემები URL-ში არ გამოჩნდება; მონაცემები იგზავნება URL-encoded body-ში.

send.sh

# SMS გაგზავნა — cURL-ის ძირითადი მაგალითი

# POST მოთხოვნა
curl -X POST "https://sender.ge/api/send.php" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  --data-urlencode "smsno=1" \
  --data-urlencode "destination=555123456" \
  --data-urlencode "content=SMS_Text"

# priority ფლაგით — SMS გამოწერის შემოწმების გამოტოვება (საჭიროებს Brand Name-იდან აქტივაციას)
curl -X POST "https://sender.ge/api/send.php" \
  --data-urlencode "apikey=YOUR_API_KEY" \
  --data-urlencode "smsno=1" \
  --data-urlencode "destination=555123456" \
  --data-urlencode "content=SMS_Text" \
  --data-urlencode "priority=1"

# პარამეტრები:
# apikey       - თქვენი API გასაღები (სავალდებულო)
# smsno        - 1 — SmsNo-თი (სარეკლამო), 2 — SmsNo-ს გარეშე (საინფორმაციო) (სავალდებულო)
# destination  - 9-ნიშნა ქართული მობილურის ნომერი (+995-ის გარეშე) (სავალდებულო)
# content      - შეტყობინების ტექსტი (სავალდებულო)
# priority     - 1 — SMS გამოწერის შემოწმების გამოტოვება (არასავალდებულო; საჭიროებს Brand Name-იდან აქტივაციას)

# HTTP პასუხის კოდები:
# 200 OK: {"data":[{"messageId":"123KUxuhiGyDN3","statusId":1,"qnt":1}]}
# 401 Unauthorized: {"message":"invalid apikey"}
# 402 Payment Required: {"message":"overdraft"}
# 403 Forbidden: {"message":"destination incorrect"}
# 403 Forbidden: {"message":"sms subscription has been canceled"}
# 429 Too Many Requests: {"message":"daily test limit reached (50 segments)"}
# 503 Service Unavailable: {"message":"Service Unavailable"}

200 OKპასუხის მაგალითი

{
  "data": [
    {
      "messageId": "123KUxuhiGyDN3",
      "statusId": 1,
      "qnt": 1
    }
  ]
}

BEFORE YOU START

ინტეგრაციის საფუძვლები

ავტორიზაცია

ყველა მოთხოვნა საჭიროებს apikey-ს. შეინახეთ გასაღები მხოლოდ server-side გარემოში და არასოდეს ჩასვათ საჯარო კოდში.

Production მეთოდი

გამოიყენეთ POST და application/x-www-form-urlencoded. GET მხარდაჭერილია მხოლოდ ძველი ინტეგრაციებისთვის.

Timeout და Retry

დააყენეთ 15-წამიანი timeout. გაურკვეველი შედეგისას ჯერ გადაამოწმეთ სტატუსი, რათა SMS არ დუბლირდეს.

უსაფრთხოების რეკომენდაციაGET მოთხოვნისას API გასაღები შეიძლება დაფიქსირდეს browser history-ში, proxy-სა და server log-ებში. ახალი ინტეგრაციებისთვის ყოველთვის გამოიყენეთ POST.

API REFERENCE

Endpoint-ები

სამივე ოპერაცია მხარდაჭერილია POST მეთოდით. ქვემოთ მოცემულია ველები, ტიპები, მაგალითები და შესაძლო პასუხები.

SMS გაგზავნა

კოდის მაგალითი

SMS-ის გაგზავნა აბონენტთან. Production ინტეგრაციისთვის რეკომენდებულია POST; GET ხელმისაწვდომია თავსებადობისთვის.

POSTრეკომენდებული

https://sender.ge/api/send.php პარამეტრები Request Body-ში

GET · ძველ ინტეგრაციებთან თავსებადობა

GETLEGACY

https://sender.ge/api/send.php?apikey=...&smsno=...&destination=...&content=... მხოლოდ ძველი ინტეგრაციებისთვის

პარამეტრები

SMS გაგზავნა — მოთხოვნის პარამეტრები
პარამეტრი	აღწერა	მაგალითი
`apikey` `string`required	თქვენი API გასაღები	`YOUR_API_KEY`
`smsno` `integer`required	1 — SmsNo-თი (სარეკლამო), 2 — SmsNo-ს გარეშე (საინფორმაციო)	`1`
`destination` `string`required	9-ნიშნა ქართული მობილურის ნომერი (+995-ის გარეშე)	`555123456`
`content` `string`required	შეტყობინების ტექსტი	`SMS_Text`
`priority` `integer`optional	1 — SMS გამოწერის შემოწმების გამოტოვებასაჭიროებს Brand Name-იდან აქტივაციას	`1`

პასუხის კოდები

200 OK

{
  "data": [
    {
      "messageId": "123KUxuhiGyDN3",
      "statusId": 1,
      "qnt": 1
    }
  ]
}

401 Unauthorized
```
{
  "message": "invalid apikey"
}
```
402 Payment Required
```
{
  "message": "overdraft"
}
```

403 Forbidden

{
  "message": "destination incorrect"
}

403 Forbidden

{
  "message": "sms subscription has been canceled"
}

429 Too Many Requests

{
  "message": "daily test limit reached (50 segments)"
}

503 Service Unavailable
```
{
  "message": "Service Unavailable"
}
```

მიწოდების სტატუსი

კოდის მაგალითი

გაგზავნილი SMS-ის მიწოდების სტატუსის შემოწმება messageId-ით.

POSTრეკომენდებული

https://sender.ge/api/callback.php პარამეტრები Request Body-ში

GET · ძველ ინტეგრაციებთან თავსებადობა

GETLEGACY

https://sender.ge/api/callback.php?apikey=...&messageId=... მხოლოდ ძველი ინტეგრაციებისთვის

პარამეტრები

მიწოდების სტატუსი — მოთხოვნის პარამეტრები
პარამეტრი	აღწერა	მაგალითი
`apikey` `string`required	თქვენი API გასაღები	`YOUR_API_KEY`
`messageId` `string`required	გაგზავნის პასუხში მიღებული messageId	`123KUxuhiGyDN3`

პასუხის კოდები

200 OK

{
  "data": [
    {
      "destination": "555123456",
      "statusId": 1,
      "timestamp": "2024-01-01 12:00:00"
    }
  ]
}

401 Unauthorized
```
{
  "message": "unauthorized apikey"
}
```
403 Forbidden
```
{
  "message": "no record found"
}
```
503 Service Unavailable
```
{
  "message": "service unavailable"
}
```

statusId მნიშვნელობები: 0 — Pending, 1 — Delivered, 2 — Undelivered

ბალანსის შემოწმება

კოდის მაგალითი

ანგარიშის მიმდინარე ბალანსის შემოწმება.

POSTრეკომენდებული

https://sender.ge/api/getBalance.php პარამეტრები Request Body-ში

GET · ძველ ინტეგრაციებთან თავსებადობა

GETLEGACY

https://sender.ge/api/getBalance.php?apikey=... მხოლოდ ძველი ინტეგრაციებისთვის

პარამეტრები

ბალანსის შემოწმება — მოთხოვნის პარამეტრები
პარამეტრი	აღწერა	მაგალითი
`apikey` `string`required	თქვენი API გასაღები	`YOUR_API_KEY`

პასუხის კოდები

200 OK

{
  "data": {
    "balance": "123.45",
    "overdraft": "0.00"
  }
}

404 Not Found
```
{
  "message": "user not found"
}
```

MESSAGE LIFECYCLE

სტატუსების ციკლი

გაგზავნის პასუხი ადასტურებს მოთხოვნის მიღებას; საბოლოო მიწოდება მოწმდება მიღებული messageId-ით.

01Submittedმოთხოვნა მიღებულია

02PendingstatusId: 0

03ADeliveredstatusId: 1

03BUndeliveredstatusId: 2

RELIABILITY

შეცდომები და უსაფრთხო Retry

4xx — მოთხოვნა შეასწორეთ

API key, პარამეტრები, წვდომა ან ბალანსი გადაამოწმეთ. იგივე მოთხოვნა უცვლელად არ გაიმეოროთ.

503 — დროებითი შეფერხება

გამოიყენეთ exponential backoff. გაგზავნისას ჯერ გადაამოწმეთ, ხომ არ შეიქმნა messageId.

Request logging

შეინახეთ დრო, endpoint, HTTP კოდი და messageId, მაგრამ არასოდეს ჩაწეროთ სრული API გასაღები.

დოკუმენტაციის რესურსები