API getrecordingcertification: Difference between revisions

Latest revision as of 18:48, 24 July 2026

7Kas VoIP REST API function. Available to: SuperRoot, 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 SuperRoot, API profile Operator, API profile Client (of operator), API profile Client (direct)

@@ Line 2: / Line 2: @@
 == 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 ==
@@ Line 20: / Line 20: @@
 == 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)]]
 [[Category:API SuperRoot]][[Category:API Operator]][[Category:API Client]][[Category:API function]]