Download OpenAPI specification:Download
mediana sms api doc sdks for some programming languages is in out github at https://github.com/medianasms api-key format: Authorization: "AccessKey your-api-key"
{- "status": "OK",
- "code": 200,
- "message": "Ok",
- "data": {
- "user": {
- "id": 1,
- "username": "admin",
- "name": "sdfsdf",
- "email": "asd@asd.asda",
- "document_block": "yes",
- "send_block": "yes",
- "mobile": "12323",
- "tellephone": "123123",
- "national_id": "aasda",
- "certificate_id": "asdad",
- "address": "sdf",
- "postal_code": "123",
- "company": "sdf",
- "expire": "2017-01-01T00:00:00Z",
- "status": "active"
}
}
}
send SMS
parameters
originator required | string your line number to send message from that |
recipients required | Array of strings recipients number |
message required | string message to send |
ok
unauthorized
{- "originator": "+9850002",
- "recipients": [
- "989123456789",
- "989125554433"
], - "message": "mediana is awesome"
}
{- "value": {
- "status": "OK",
- "code": 200,
- "message": "Ok",
- "data": {
- "bulk_id": 52738692
}
}
}
create message pattern
parameters
pattern required | string pattern template |
description | string pattern description |
is_shared | boolean determine that pattern shared or not |
ok
unauthorized
{- "pattern": "Hello %name%",
- "description": "greeter pattern",
- "is_shared": false
}
{- "value": {
- "status": "OK",
- "code": 200,
- "message": "Ok",
- "data": {
- "pattern": {
- "code": "6gr7ngjmhi",
- "status": "pending",
- "message": "salam %name%!",
- "is_shared": false
}
}
}
}
send pattern SMS
parameters
pattern_code required | string pattern code |
originator required | string your line number to send message from that |
recipient required | string recipient number |
values required | object pattern values |
ok
unauthorized
{- "pattern_code": "t2cfmnyo0c",
- "originator": "+9850002",
- "recipient": "+989123459900",
- "values": {
- "name": "Mohamad"
}
}
{- "value": {
- "status": "OK",
- "code": 200,
- "message": "Ok",
- "data": {
- "bulk_id": 52738692
}
}
}
get a sms properties
bulk_id required | integer <int64> Example: 52738671 |
ok
unauthorized
{- "status": "OK",
- "code": 200,
- "message": "Ok",
- "data": {
- "message": {
- "bulk_id": 52738671,
- "number": "+9850002",
- "message": "Hello from me",
- "status": "active",
- "type": "webservice",
- "confirm_state": "",
- "created_at": "2019-12-07T13:34:06Z",
- "sent_at": "2019-12-07T13:34:06Z",
- "recipients_count": 1,
- "valid_recipients_count": 0,
- "page": 1,
- "cost": 0,
- "payback_cost": 0,
- "description": "single send"
}
}
}
get a sms recipients status
bulk_id required | integer <int64> Example: 52738671 |
page | integer <uint64> Example: page=0 |
limit | integer <int64> Example: limit=10 |
ok
unauthorized
{- "status": "OK",
- "code": 200,
- "message": "Ok",
- "data": {
- "recipients": [
- {
- "recipient": "+98912345xxxx",
- "status": "send"
}
]
}, - "meta": {
- "total": 1,
- "pages": 1,
- "limit": 1,
- "page": 0,
- "prev": null,
- "next": null
}
}
fetch inbox messages
page | integer <uint64> Example: page=0 |
limit | integer <int64> Example: limit=10 |
ok
unauthorized
{- "status": "OK",
- "code": 200,
- "message": "Ok",
- "data": {
- "messages": [
- {
- "number": "+98100020400",
- "message": "سشیسشیسشیسش",
- "sender": "5555",
- "time": "1970-01-01T04:05:55Z",
- "type": "normal"
}
]
}, - "meta": {
- "total": 1,
- "pages": 1,
- "limit": 1,
- "page": 0,
- "prev": null,
- "next": null
}
}