APIanna tríú páirtí (b77.http)

Glaonn b77.http.fetch ar API HTTPS tríú páirtí ó fhreastalaithe builder77. Stóráiltear d'eochracha API faoi Socruithe → Eochracha rúnda agus scríobhtar sa chód iad mar {{secret:NAME}}: líonann an freastalaí isteach iad, mar sin ní shroicheann siad an brabhsálaí riamh.

const res = await b77.http.fetch('https://api.openai.com/v1/chat/completions', {
  method: 'POST',                                          // default GET
  headers: { Authorization: 'Bearer {{secret:OPENAI_API_KEY}}' },
  body: { model: 'gpt-4o-mini', messages: [{ role: 'user', content: 'Hi!' }] }, // object → JSON, or a string
});
if (res.ok) console.log(res.data);  // { ok, status, headers, body (text), data (parsed JSON or null) }

Úsáideann gach glao 1 chreidmheas comhtháthaithe. https amháin, teorainn ama 15 soicind, freagraí suas le 1 MB. Má sheolann API d'eochair ar ais, cuirtear [secret] ina háit sula bhfeiceann d'aip an freagra.

Rialacha do gach eochair rúnda

Is féidir le duine ar bith a úsáideann d'aip glaonna a dhéanamh le heochair rúnda — gan í a fheiceáil. Mar sin ní oibríonn gach eochair ach sa tslí a cheadaíonn tú:

• Óstaí ceadaithe — na freastalaithe amháin a seoltar chucu í riamh (m.sh. api.openai.com; clúdaíonn *.example.com fofhearainn).
• Modhanna ceadaithe — GET agus POST de réir réamhshocraithe.
• Conairí ceadaithe — réimíreanna conaire roghnacha, mar /v1/chat/. Ciallaíonn folamh conair ar bith.
• Cá bhféadfar an eochair a chur — de réir réamhshocraithe, i gceanntásc dintiúr amháin (Authorization, X-Api-Key, Api-Key, X-Goog-Api-Key agus a leithéid). Tá paraiméadair fiosrúcháin (de réir ainm, m.sh. key), conair an URL agus corp an iarratais múchta go dtí go gcasann tú air iad.

Diúltaítear do ghlao a sháraíonn riail, le stádas 403, sula seoltar aon rud.

Eochracha san URL nó sa chorp

Is fearr APIanna a ghlacann leis an eochair i gceanntásc. Éilíonn cuid acu sa seoladh í ina ionad sin — ceadaigh an áit sin go díreach agus cúngaigh an chonair:

// Settings → Secrets: TELEGRAM_TOKEN, host api.telegram.org, "In the URL path" on,
// allowed path /bot{{secret:TELEGRAM_TOKEN}}/sendMessage
await b77.http.fetch('https://api.telegram.org/bot{{secret:TELEGRAM_TOKEN}}/sendMessage', {
  method: 'POST',
  body: { chat_id: 12345, text: 'New booking!' },
});

Ná ceadaigh I gcorp an iarratais ach amháin má éilíonn an API é: d'fhéadfadh duine ar bith a úsáideann d'aip an eochair a scríobh ansin in aon rud a shábhálann an API sin (teachtaireacht, nóta, comhad poiblí) agus í a léamh ar ais.