API profile Operator: Difference between revisions
Appearance
API docs (generated from func=help) |
API docs (generated from func=help) |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
''Profile '''Operator''' (reseller): | ''Profile '''Operator''' (reseller): 37 functions over its own root. Sees account and root prices and profit (VOC). No SuperRoot-only functions.'' | ||
== Meta / discovery == | == Meta / discovery == | ||
| Line 23: | Line 23: | ||
== CDR (call detail) == | == CDR (call detail) == | ||
* [[API getcdr]] — Call Detail Records (CDR) for a period. | * [[API getcdr]] — Call Detail Records (CDR) for a period. | ||
== Call recordings == | |||
* [[API getrecordings]] — Lists the caller's call recordings with availability flags (has_transcript, has_summary, has_audio). | |||
* [[API getrecordingtranscript]] — Returns the transcription of one of the caller's recordings, with or without the summary (resumen). | |||
* [[API getrecordingfile]] — Downloads the audio recording (stereo MP3) of one of the caller's calls. | |||
* [[API getrecordingcertification]] — Downloads the integrity/veracity certification file (.txt) of one of the caller's recordings: file, user, date, time, uniqueid, src, dst and the SHA-512 hash (matches voip_callrecord.recordhash). | |||
== CLIs / lines == | == CLIs / lines == | ||
* [[API getclis]] — Lists CLIs (caller-line identities / DDIs) for the account. | * [[API getclis]] — Lists CLIs (caller-line identities / DDIs) for the account. | ||
Latest revision as of 07:39, 23 July 2026
Profile Operator (reseller): 37 functions over its own root. Sees account and root prices and profit (VOC). No SuperRoot-only functions.
Meta / discovery
- API help — Lists the API functions available to the role of the calling ukey, with each function's description, parameters (meaning, optional/default), an example call and the response format.
Outgoing call billing
- API getcallsbilling — Outgoing-call billing records for a period.
- API getcallsbillingtotalroot — Monthly billing total for one root/operator (TOC).
- API getcallsbillingcount — Row count for the given filter (smart pagination).
- API getcallsbillingtotal — Grand billing total for the caller's scope for the month.
- API getcallsbillingaccounttotal — Monthly billing total for one account.
- API getcallsbillingdetailtotal — Total over VOC detail rows matching the filter (with total_rows for pagination).
- API getcallsbillingcomis — Commission billing for a commissioner: aggregates the calls of the accounts assigned to the caller (accountcode_comis) and returns commission minutes/amount — never exposing costs.
Pay-per-use services
- API getservices — Detail of pay-per-use services (dtype=SERVICIOS, e.g.
- API getservicestotal — Aggregate total of pay-per-use services for the period (all services, or one via service=<prefix>).
Incoming calls
- API getincomingcalls — Incoming-call records for a period.
- API getincomingcallstotalroot — Monthly incoming total for one root/operator (TIC).
- API getincomingcallscount — Row count for the given filter (smart pagination).
- API getincomingcallstotal — Grand incoming total for the caller's scope for the month.
- API getincomingcallsaccounttotal — Monthly incoming total for one account.
- API getincomingcallsdetailtotal — Total over VIC detail rows matching the filter (with total_rows for pagination).
CDR (call detail)
- API getcdr — Call Detail Records (CDR) for a period.
Call recordings
- API getrecordings — Lists the caller's call recordings with availability flags (has_transcript, has_summary, has_audio).
- API getrecordingtranscript — Returns the transcription of one of the caller's recordings, with or without the summary (resumen).
- API getrecordingfile — Downloads the audio recording (stereo MP3) of one of the caller's calls.
- API getrecordingcertification — Downloads the integrity/veracity certification file (.txt) of one of the caller's recordings: file, user, date, time, uniqueid, src, dst and the SHA-512 hash (matches voip_callrecord.recordhash).
CLIs / lines
- API getclis — Lists CLIs (caller-line identities / DDIs) for the account.
Tucloud PBX
- API getpbxloclog — Tucloud PBX IVR/locution DTMF key-press log for a period.
Account management
- API getaccountcodeid — Lists (id, accountcode) pairs of the accounts under the caller.
- API getaccountcodedata — Returns full account profile rows (view_voip_users_api) for the caller's accounts.
- API lockaccountcode — Blocks (locks) an account (blocked=SI).
- API unlockaccountcode — Unblocks (unlocks) an account (blocked=NO).
- API addaccountcode — Creates a new account (client) under the caller.
- API getcredit — Returns credit and status (credit, credit_limit, creditalarm, email, blocked).
WireGuard / VPN
- API getwgpeers — Lists WireGuard peers of a server (SSIP-transparent union of SSIP + VPN pairs).
- API setwgstatus — Enables/disables a WireGuard peer.
- API registerwgserver — Registers/updates a WireGuard server (public key, listen port, endpoint).
- API registerwgdevice — Registers an SSIP device's WireGuard public key (keyed by device MAC).
- API getwgconfig — Returns the WireGuard config for an SSIP device, authenticated by the device's vpnpassword (no role gate — any valid ukey with the correct password).
- API registervpnwgdevice — Registers a non-SSIP VPN WireGuard device, authenticated by (host, password) of the VPN pair (voip_vtun).
- API getvpnwgconfig — Returns the WireGuard config for a non-SSIP VPN device, authenticated by (host, password) of the VPN pair.
Diagnostics
- API helloworld — Health check / connectivity test.