Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

GET u DELETE: Ġestjoni tar-Risposti

Lezzjoni 7 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Lil hinn mill-Ħolqien
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. L-Aħjar Prattiki
  5. Punti Ewlenin

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_id bejn ir-risposti tiegħek

Punti Ewlenin

  • GET /v1/responses/{id} jirkupra risposta bil-kontenut u l-metadejta kollha tagħha
  • DELETE /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à