Grandstream Networks, Inc.
GSC3505/3510/3506/3516-sarja
CTI opas
GSC35XX: CTI opas
Pyynnön muoto
Yleinen CTI-komentopyyntömuoto on: http://phone-IP-Address-cgi-bin-function.passcode.PASSWORD¶m.value
"Function" on yksi CTI-funktioista, kuten seuraavassa luvussa kuvataan (api-get_line_status esim.ample)
"Salasana" on puhelimen järjestelmänvalvojan tason salasana "Param=arvo" on tietyn CTI-toimintotyypin parametri
Vastauksen muoto
Myönteinen vastaus ilman palautettua arvoa
{"vastaus":"menestys", "teksti": "valmis"}
Kielteinen vastaus
{"response":"error", "body": "epäonnistui"}
Positiivinen vastaus palautetuilla arvoilla
{"response":"success", "body": [{"rivi": 1, "state": "idle", "act": "","remotename": "", "remotenumber":
"", "active": 0}, {"line": 2,"state":"idle", "act": "", "remotename": "", "remotenumber": "", "active":
0},{"rivi": 3, "tila": "idle", "act": "", "remotename": "", "remotenumber": "", "active": 0}]}
CTI-TOIMINTOJEN TYYPPI
Katso seuraava taulukko, joka kuvaa tuettujen CTI-toimintojen tyyppejä:
| Tyyppi | Toiminto | Kuvaus | Menetelmä |
| Puhelimen tila | api-get_phone_status | Hakee puhelimen tilan | SAADA |
| Soita | api-make_call | Soita yleinen puhelu | SAADA |
| Puhelintoiminnot | api-phone_operation | Lähettää puhelimen toimintokomentoja (katkaise puhelu, vastaa puheluun, hylkää puhelu…) | SAADA |
| Järjestelmän toiminnot | api-sys_operation | Lähettää järjestelmän toimintokomennot (reset, reboot…) | SAADA |
| Hanki paikallinen musiikkiluettelo | api-get_music | saada laitteeseen tallennettu paikallinen musiikkiluettelo | SAADA |
| Musiikin toiston ohjaus | api-ctrl_music_play | ohjata paikallista musiikin toistoa tai lopettaa se | SAADA |
Tuetut CTI-toiminnot
CTI-KOMENNOT JA EXAMPLES
Seuraavat komennot on suoritettu a web selain saman puhelimen verkossa olevalla tietokoneella. ExampAlla olevissa tapauksissa käytetään GSC3516-laitetta, jonka IP-osoite on 192.168.5.135 ja järjestelmänvalvojan tason salasana asetettu oletusarvoiksi (passcode=admin).
Puhelimen tilatoiminto
Yleinen muoto
CTI-komennon yleinen muoto puhelimen tilan hakemiseksi on:
http://Phone-IP-Address-cgi-bin-api-get_phone_status.passcode=PASSWORD
Johdatus URL parametrit
salasana : PASSWORD
Example
| Pyytää | http://192.168.5.135-cgi-bin-api-get_phone_status.passcode=admin |
| Vastaus | Puhelin saatavilla {"response":"success", , "sekalaiset": "1"} "body": "saatavilla" Puhelin varattu {"response":"success", "sekalaiset": "1"} "body": "varattu", |
Soita
Yleinen muoto
CTI-komennon yleinen muoto puhelun aloittamiseksi on:
http://Phone-IP-Address-cgi-bin-api-make_call.passcode=PASSWORD&phonenumber=NUMBER
Johdatus URL parametrit
salasana : PASSWORD
puhelinnumero: puhelinnumero
Example
| Pyytää | http://192.168.5.135-cgi-bin-api-make_call.passcode=admin&phonenumber=35463 |
| Vastaus | { "vastaus": "menestys", "vartalo": totta } |
Puhelintoimintojen toiminnot
Yleinen muoto
CTI-komennon yleinen muoto puhelintoimintojen lähettämiseksi on:
http://Phone-IP-Address-cgi-bin-api-phone_operation.passcode=PASSWORD&cmd=CMD
Johdatus URL parametrit
salasana : PASSWORD
cmd: puhelimen toimintojen toiminnot
Examples
| Toiminta | Toiminto | Examples |
| lopetuspuhelu | Lopeta muodostettu puhelu | http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=endcall |
| hyväksy puhelu | Hyväksy saapuva puhelu | http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=acceptcall |
| hylätä puhelu | Hylkää saapuva puhelu | http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=rejectcall |
| mykistää | Mykistä tai poista mykistys puhelujen aikana | http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=mute ensimmäinen liipaisin on mykistetty, sitten toinen liipaisin on mykistetty. |
Järjestelmän toiminnot
Yleinen muoto
Yleinen CTI-komento järjestelmätoimintojen lähettämiseksi on:
http://Phone-IP-Address-cgi-bin-api-sys_operation.passcode=PASSWORD&request=CMD
Johdatus URL parametrit
salasana : PASSWORD
pyyntö: järjestelmätoimintojen toiminnot
Examples
| Toiminta | Toiminto | Example |
| KÄYNNISTÄ UUDELLEEN | Käynnistä laite uudelleen | http://192.168.5.135/cgi-bin/api-sys_operation?passcode=admin&request=REBOOT |
| RESET | Palauta laite oletusasetuksiin | http://192.168.5.135-cgi-bin-api-sys_operation.passcode=admin&request=RESET |
Hanki paikallinen musiikkiluettelo
Yleinen muoto
Yleinen CTI-komento paikallisen musiikkiluettelon saamiseksi on:
http://Phone-IP-Address-cgi-bin-api-get_music.passcode=PASSWORD
Johdatus URL parametrit
salasana : PASSWORD
Example
| Pyytää | http://192.168.5.135-cgi-bin-api-get_music.passcode=admin |
| Vastaus | {"response":"success", "body":[{"fileNimi": "musiikki1.ogg", "polku": "/var/user/music/music1.ogg"}, {“fileNimi": "music2.ogg", "polku":"/var/user/music/music2.ogg"} ]} |
Musiikin toiston ohjaus
Yleinen muoto
Yleinen CTI-komento musiikin toistoon tai lopettamiseen on:
http://Phone-IP-Address-cgi-bin-api-ctrl_music_play.passcode=PASSWORD&state=STATE&type=TYPE&url=URL&loop=LOOP
Johdatus URL parametrit
salasana : PASSWORD
tila : lopeta tai toista musiikkia. (0 – pysäytys; 1 – toisto)
tyyppi: 1, oletusarvo
url : Musiikin toistopolku, voit hankkia musiikkipolkuja "api-get_music"-käyttöliittymän kautta
loop : Yksittäinen tai jatkuva toisto. (0 – yksittäinen; 1 – silmukka)
Example
Tuetut mallit
| Mallin nimi | CTI-tuki | Laiteohjelmistovaatimukset |
| GSC3505 | KYLLÄ | 1.0.3.8 tai enemmän |
| GSC3510 | KYLLÄ | 1.0.3.8 tai enemmän |
| GSC3506 | KYLLÄ | 1.0.3.8 tai enemmän |
| GSC3516 | KYLLÄ | 1.0.3.8 tai enemmän |
Tuetut GSC-mallit
Tarvitsetko tukea?
Etkö löydä etsimääsi vastausta? Älä huoli, olemme täällä auttamassa!
OTA YHTEYTTÄ TUKEEN

Asiakirjat / Resurssit
![]() |
GRANDSTREAM GSC3505 1-suuntainen julkinen SIP-puhelinkaiutin [pdfKäyttöopas GSC3505 1-suuntainen julkinen SIP-sisäpuhelinkaiutin, GSC3505, 1-suuntainen julkinen SIP-sisäpuhelinkaiutin, yleinen osoite SIP-sisäpuhelinkaiutin, osoite SIP-sisäpuhelikaiutin, SIP-sisäpuhelinkaiutin, sisäpuhelinkaiutin |
