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

Sejjaħ l-API b'cURL

Lezzjoni 8 / 14 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-għodda universali biex tittestja l-APIs
  2. L-ewwel talba cURL tiegħek
  3. Uża l-endpoint /v1/responses
  4. Għażliet utli ta’ cURL
  5. Estrai biss it-tweġiba
  6. Ara l-intestazzjonijiet tar-risposta
  7. Aqra l-korp minn fajl
  8. Iddibbuggja żbalji komuni
  9. Punti Ewlenin

L-għodda universali biex tittestja l-APIs

cURL huwa għodda tal-linja tal-kmand disponibbli fuq kull sistema operattiva. Jippermettilek tibgħat talbiet HTTP mingħajr ma tinstalla SDK jew tikteb programm. Hija l-għodda ideali biex tittestja endpoint malajr, tiddibbuggja talba, jew tawtomatizza sejħiet fi skritt tal-qoxra (shell script).

L-ewwel talba cURL tiegħek

Hekk kif tibgħat talba lill-API ta’ Grok b’cURL:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [
      {"role": "user", "content": "Hello, introduce yourself in one sentence."}
    ]
  }'

Analiżi tal-kmand

  • curl https://api.x.ai/v1/chat/completions: jibgħat talba POST (implikata minn -d) lejn l-endpoint
  • -H "Authorization: Bearer $XAI_API_KEY": jżid l-intestazzjoni tal-awtentikazzjoni bil-muftaħ tiegħek
  • -H "Content-Type: application/json": jindika li l-korp huwa JSON
  • -d '{...}': il-korp tat-talba f’format JSON

Uża l-endpoint /v1/responses

L-endpoint modern /v1/responses joffri sintassi iktar konċiża:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Explain machine learning to me in simple terms."
  }'

Innota li input tissostitwixxi messages għal talbiet sempliċi. Tista’ tgħaddi stringa direttament minflok array ta’ messaġġi.

Għażliet utli ta’ cURL

Ifformatta l-output JSON

Ir-risposta raw hija diffiċli biex taqraha. Uża jq biex tiffurmattja:

curl -s https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.5", "input": "Hello"}' | jq .

L-għażla -s (silent) taħbi l-linja tal-progress ta’ cURL.

Estrai biss it-tweġiba

Biex tikseb it-test tat-tweġiba mingħajr il-metadejta:

curl -s https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }' | jq -r '.choices[0].message.content'

Ara l-intestazzjonijiet tar-risposta

Biex tiddibbuggja limiti ta’ rati jew żbalji, żid -i biex turi l-intestazzjonijiet HTTP:

curl -i https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.5", "input": "Test"}'

Aqra l-korp minn fajl

Għal talbiet kumplessi, aħżen il-JSON f’fajl:

# request.json
{
  "model": "grok-4.5",
  "messages": [
    {"role": "system", "content": "You are a translator."},
    {"role": "user", "content": "Translate into French: Hello world"}
  ],
  "temperature": 0.3
}

Imbagħad irreferenzjah b’@:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Iddibbuggja żbalji komuni

  • 401 Unauthorized: muftaħ API invalidu jew nieqes. Iċċekkja echo $XAI_API_KEY
  • 400 Bad Request: JSON malformat. Ivvalida l-JSON tiegħek b’jq . < request.json
  • 429 Too Many Requests: laqqt il-limitu tar-rata. Stenna ftit sekondi
  • 404 Not Found: iċċekkja l-URL u l-mogħdija tal-endpoint

Punti Ewlenin

  • cURL huwa perfett biex tittestja u tiddibbuggja mingħajr ma tikteb kodiċi
  • Awtentika b’-H "Authorization: Bearer $XAI_API_KEY"
  • Uża jq biex tifformatta u tiffiltra risposti JSON
  • Aħżen talbiet kumplessi f’fajls JSON separati