Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

GET ja DELETE: Vastausten hallinta

Oppitunti 7 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Luomisen tuolla puolen
  2. GET /v1/responses/{id}
  3. DELETE /v1/responses/{id}
  4. Parhaat käytännöt
  5. Keskeiset asiat

Luomisen tuolla puolen

Responses API ei rajoitu pelkästään vastausten luomiseen. Kaksi täydentävää päätepistettä mahdollistavat tallennettujen vastausten noutamisen ja poistamisen. Nämä toiminnot ovat välttämättömiä historiahallinnan tarjoavien robustien sovellusten rakentamisessa.

GET /v1/responses/{id}

Vastauksen noutaminen

curl https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

API palauttaa täsmälleen saman JSON-objektin kuin luontivaiheessa:

{
  "id": "resp-abc123def456",
  "object": "response",
  "created_at": 1712000000,
  "status": "completed",
  "model": "grok-4.20-0309-reasoning",
  "output": [...],
  "usage": {...}
}

Käytännön käyttötapaukset

Keskustelun jatkaminen: Sovelluksesi tallentaa viimeisimmän response_id:n käyttäjäistuntoon. Yhteyden muodostuessa uudelleen noudat vastauksen näyttääksesi edellisen kontekstin.

# Käyttäjä palaa tauon jälkeen
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)

# Näytä viimeisin vaihto
print(f"Viimeisin vastaus: {previous.output[0].content[0].text[:200]}...")

# Jatka keskustelua
new_response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Missä jäimme?",
    previous_response_id=last_response_id
)

Kustannusauditointi: Käy läpi tallennetut vastauksesi analysoidaksesi kulutusta käyttäjäkohtaisesti tai ominaisuuskohtaisesti.

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"Kustannus: ${cost_usd:.6f} | Sisään: {input_tokens} | Ulos: {output_tokens}")

Virheenkäsittely

Jos vastausta ei ole olemassa (se on poistettu tai vanhentunut), API palauttaa 404-virheen:

{
  "error": {
    "message": "Response not found",
    "type": "not_found_error"
  }
}

Käsittele tämä tilanne koodissasi:

try:
    response = client.responses.retrieve("resp-expired123")
except Exception as e:
    print(f"Vastausta ei löytynyt: {e}")
    # Aloita uusi keskustelu

DELETE /v1/responses/{id}

Vastauksen poistaminen

curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
  -H "Authorization: Bearer $XAI_API_KEY"

Poistaminen palauttaa onnistuessaan tilakoodin 200. Toiminto on palautumaton.

Vaikutus ketjutettuihin keskusteluihin

Kun poistat vastauksen, johon muut viittaavat previous_response_id:n kautta, kyseisen vastauksen konteksti katoaa ketjusta. Myöhempiä vastauksia ei poisteta, mutta ne menettävät pääsyn edeltävään kontekstiin.

resp-1 → resp-2 → resp-3 → resp-4
         ↑ poistettu

Jos poistat resp-2:n, resp-3 ja resp-4 ovat edelleen olemassa, mutta konteksti resp-1:stä ja resp-2:sta ei ole enää saatavilla uusiin ketjutettuihin pyyntöihin.

Automatisoitu siivous

Tuotantosovelluksille kannattaa toteuttaa säännöllinen siivous:

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"Poistettu: {rid}")
        except Exception:
            pass  # Jo poistettu tai vanhentunut

Parhaat käytännöt

  • Tallenna ID:t: säilytä response_id:t tietokannassasi yhdessä keskustelun metatietojen kanssa
  • Siivoa säännöllisesti: älä odota automaattista 30 päivän vanhenemista arkaluonteisen datan kohdalla
  • Käsittele 404-virheet: vastaus voi kadota pyyntöjen välillä (vanheneminen, manuaalinen poisto)
  • Dokumentoi ketjusi: vianetsintää varten jäljitä previous_response_id -linkit vastaustesi välillä

Keskeiset asiat

  • GET /v1/responses/{id} noutaa vastauksen koko sisällön ja metatietoineen
  • DELETE /v1/responses/{id} poistaa vastauksen pysyvästi – palautumaton toiminto
  • Välivastauksen poistaminen katkaisee keskusteluketjun kontekstin
  • Käsittele 404-virheet: vastaukset vanhenevat automaattisesti 30 päivän jälkeen
  • Säilytä response_id:t omassa tietokannassasi jäljitettävyyden varmistamiseksi