документация API
| Версия | Документация |
|---|---|
| Самый последний | последняя документация API |
Вы можете отправлять смс через API или создавать веб-зацепки, чтобы получать уведомления в своем собственном бэкэнде о полученных смс на подключенном смартфоне.
Optional: omit sim_card to use your primary SIM; if it is unavailable, the next SIM by route priority is used as fallback. Configure priorities under MCP Setup / Dashboard.
MCP agent
Прежде чем вы сможете использовать API, вы должны создать токен доступа .
Получить список сим-карт
curl \
--header 'Accept: application/json; indent=4' \
--header 'Authorization: Token <ACCESS_TOKEN>' \
--request GET https://www.tincansmartphone.com/api/sim-card/
Отправить смс через конкретную сим-карту
curl \
--header 'Content-Type: application/json' \
--header 'Accept: application/json; indent=4' \
--header 'Authorization: Token <ACCESS_TOKEN>' \
--data '{"sim_card":"<SIM_CARD_ID>", "to_number":"<RECEIVER_PHONE_NUMBER>", "text": "Hello!"}' \
--request POST https://www.tincansmartphone.com/api/sms-out/
Создать webhook для полученных смс
curl \
--header 'Content-Type: application/json' \
--header 'Accept: application/json; indent=4' \
--header 'Authorization: Token <ACCESS_TOKEN>' \
--data '{"target": "http://example.com/target.php", "event": "sms.in.received"}' \
--request POST https://www.tincansmartphone.com/api/hooks/
Создать webhook для отправленных смс
curl \
--header 'Content-Type: application/json' \
--header 'Accept: application/json; indent=4' \
--header 'Authorization: Token <ACCESS_TOKEN>' \
--data '{"target": "http://example.com/target.php", "event": "sms.out.created"}' \
--request POST https://www.tincansmartphone.com/api/hooks/
Получить список webhook
curl \
--header 'Accept: application/json; indent=4' \
--header 'Authorization: Token <ACCESS_TOKEN>' \
--request GET https://www.tincansmartphone.com/api/hooks/
Удалить webhook
curl \
--header 'Accept: application/json; indent=4' \
--header 'Authorization: Token <ACCESS_TOKEN>' \
--request DELETE https://www.tincansmartphone.com/api/hooks/<HOOK_ID>/
Доступные webhooks
| Событие | Описание |
|---|---|
| sms.out.created | Sms was sent to the Api for dispatch |
| sms.out.sent | The sms was marked as sent |
| sms.in.received | A sms was received |
| simcard.added | A sim card was added |
| simcard.changed | A sim card was changed |
| simcard.removed | A sim card was removed |
Вы можете создать webhook с помощью Rest-Api ( создать webhook - API-интерфейс) или через веб-сайт ( создать webhook - веб ).