GET u DELETE: Ġestjoni tar-Risposti
F'din il-paġna
Lil hinn mill-Ħolqien
l-API tar-Risposti mhix limitata għall-ħolqien ta’ risposti biss. Żewġ endpoints komplementari jippermettulek tirrikupra u tħassar risposti maħżuna. Dawn l-operazzjonijiet huma essenzjali biex tibni applikazzjonijiet robusti b’ġestjoni tal-istoriku.
GET /v1/responses/{id}
Irrikupra Risposta
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
l-API tirritorna l-istess oġġett JSON eżatt bħal waqt il-ħolqien:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Każijiet ta’ Użu Prattiku
Riprensjoni tal-Konversazzjoni: L-applikazzjoni tiegħek taħżen l-aħħar response_id fis-sessjoni tal-utent. Meta terġa’ tikkonnettja, irrikupra r-risposta biex turi l-kuntest preċedenti.
# L-utent jerġa' lura wara mistrieħ
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Uri l-aħħar skambju
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Kompli l-konversazzjoni
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Awditjar tal-Ispejjeż: Itera fuq ir-risposti maħżuna tiegħek biex tanalizza l-konsum skont l-utent jew il-funzjonalità.
response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")
Ġestjoni tal-Iżbalji
Jekk ir-risposta ma teżistix (imħassra jew skaduta), l-API tirritorna żball 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Iddedika dan il-każ fil-kodiċi tiegħek:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Ibda konversazzjoni ġdida
DELETE /v1/responses/{id}
Ħassar Risposta
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
It-tħassir jirritorna status 200 fuq suċċess. L-operazzjoni hija irreversibbli.
Impatt fuq Konversazzjonijiet Imqabbda
Meta tħassar risposta li hija rreferenzjata minn oħrajn permezz ta’ previous_response_id, il-kuntest ta’ dik ir-risposta jisparixxi mill-katina. Ir-risposti sussegwenti ma jitħassrux, iżda jitilfu l-aċċess għall-kuntest preċedenti.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Jekk tħassar resp-2, resp-3 u resp-4 jibqgħu jeżistu, iżda l-kuntest minn resp-1 u resp-2 ma għadux aċċessibbli għal talbiet ġodda mqaqqda.
Tindifa Awtomatizzata
Għal applikazzjonijiet ta’ produzzjoni, implimenta tindifa perjodika:
import datetime
def cleanup_old_responses(response_ids, max_age_days=7):
for rid in response_ids:
try:
resp = client.responses.retrieve(rid)
age = datetime.datetime.now().timestamp() - resp.created_at
if age > max_age_days * 86400:
client.responses.delete(rid)
print(f"Deleted: {rid}")
except Exception:
pass # Diġà mħassra jew skaduta
L-Aħjar Prattiki
- Aħżen l-IDs: żomm ir-
response_ids fid-database tiegħek flimkien mal-metadejta tal-konversazzjoni - Naddaf regolarment: tistenniex l-iskadenza awtomatika ta’ 30 jum għal data sensittiva
- Immaniġġja l-404s: risposta tista’ tisparixxi bejn it-talbiet (skadenza, tħassir manwali)
- Iddokumenta l-katini tiegħek: għad-debugging, traċċa l-links ta’
previous_response_idbejn ir-risposti tiegħek
Punti Ewlenin
GET /v1/responses/{id}jirkupra risposta bil-kontenut u l-metadejta kollha tagħhaDELETE /v1/responses/{id}iħassar risposta b’mod permanenti—operazzjoni irreversibbli- It-tħassir ta’ risposta intermedja jkisser il-kuntest tal-katina tal-konversazzjoni
- Immaniġġja l-iżbalji 404: ir-risposti jiskadu awtomatikament wara 30 jum
- Żomm ir-
response_ids fid-database tiegħek stess għat-traċċabbiltà