Jump to content

API getrecordingcertification: Difference between revisions

From Wiki 7Kas
API docs (generated from func=help)
 
API docs regenerated from func=help (operator catalogue)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
''7Kas VoIP REST API function. Available to: '''SuperRoot, Operator, Client'''.''
''7Kas VoIP REST API function. Available to: '''Operator, Client'''.''


== Description ==
== Description ==
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). Select by id OR uniqueid. Scoped by the key.
Downloads the integrity/veracity certification of one of the caller's recordings: file, user, date, time, uniqueid, src, dst and the SHA-512 hash (matches voip_callrecord.recordhash). New recordings deliver it as JSON (application/json); older ones as a legacy plain-text file, transparently. Select by id OR uniqueid. Scoped by the key.


== Call ==
== Call ==
Line 20: Line 20:


== Response ==
== Response ==
text/plain body (Content-Disposition attachment "<uniqueid>.cert.txt"). On missing/foreign: {}.
application/json body (Content-Disposition attachment "<uniqueid>.cert.json") for migrated recordings; text/plain "<uniqueid>.cert.txt" for legacy ones. On missing/foreign: {}.


----
----
Back to [[API VoIP]] · '''[[API Console|▶ Try it live]]''' · Profiles: [[API profile SuperRoot]], [[API profile Operator]], [[API profile Client (of operator)]], [[API profile Client (direct)]]
Back to [[API VoIP]] · '''[[API Console|▶ Try it live]]''' · Profiles: [[API profile Operator]], [[API profile Client (of operator)]], [[API profile Client (direct)]]
[[Category:API SuperRoot]][[Category:API Operator]][[Category:API Client]][[Category:API function]]
[[Category:API Operator]][[Category:API Client]][[Category:API function]]

Latest revision as of 13:47, 5 November 2026

7Kas VoIP REST API function. Available to: Operator, Client.

Description

Downloads the integrity/veracity certification of one of the caller's recordings: file, user, date, time, uniqueid, src, dst and the SHA-512 hash (matches voip_callrecord.recordhash). New recordings deliver it as JSON (application/json); older ones as a legacy plain-text file, transparently. Select by id OR uniqueid. Scoped by the key.

Call

GET  …/7Kas?func=getrecordingcertification&ukey=YOUR_KEY&…

Requires the ukey parameter.

Parameters

Parameter Type Required Default Meaning
id integer No — Recording id. Provide id OR uniqueid.
uniqueid string No — Call uniqueid. Provide id OR uniqueid. (max 80)

Example

https://api.7kas.com:9080/7Kas?func=getrecordingcertification&ukey=KEY&id=5270558

Response

application/json body (Content-Disposition attachment "<uniqueid>.cert.json") for migrated recordings; text/plain "<uniqueid>.cert.txt" for legacy ones. On missing/foreign: {}.


Back to API VoIP · ▶ Try it live · Profiles: API profile Operator, API profile Client (of operator), API profile Client (direct)