Referință

Erori și limite

Ce înseamnă fiecare cod de stare, propozițiile exacte și cât poți face.

Forma unei erori

Fiecare răspuns are un câmp ok. Când o cerere este refuzată, ok este false, iar error este o propoziție care spune ce a mers prost și ce să faci. Este scrisă ca să fie arătată unui om așa cum este.

json

{ "ok": false, "error": "No such app on this account." }

Un refuz nu are alte câmpuri, cu o singură excepție: o modificare care a început și apoi n-a putut rula din lipsă de credite are și outOfCredits: true.

Coduri de stare

Status	Ce înseamnă	Ce faci
`200`	Gata. La o modificare, a început, iar `ok` spune cum s-a încheiat.	Citește `ok`.
`400`	Ceva din cerere lipsește sau nu este permis.	Corectează cererea, după `error`.
`401`	Cheia lipsește, e greșită sau a fost revocată.	Verifică antetul `Authorization` și cheia.
`402`	Apelul consumă credite și nu poate: planul nu îl include sau nu sunt destule credite.	Treci la un plan mai mare sau adaugă credite, cum spune `error`.
`404`	Nu există o astfel de aplicație sau cheia ta nu o poate folosi la nivelul de care are nevoie apelul.	Verifică id-ul cu Listează aplicațiile tale.
`409`	Aplicația nu are încă cod sau, la publicare, adresa ei nu poate fi folosită.	Construiește-o mai întâi în Setherion sau citește `error`.
`429`	S-a atins o limită.	Așteaptă să se reseteze.
`500`	Ceva a eșuat la noi.	Încearcă din nou.
`502`	Publicarea a eșuat la noi.	Încearcă din nou.
`503`	O parte din Setherion nu este disponibilă pentru scurt timp.	Încearcă din nou peste un minut.

Din motive de confidențialitate, „nu există o astfel de aplicație" și „o aplicație pe care nu ai voie s-o folosești" dau același 404. Altfel, cu o cheie s-ar putea afla ce aplicații există. Asta include o aplicație pe care o poți doar vedea, când apelul cere un editor.

Cine ce poate face

Rolul tău în aplicație hotărăște ce apeluri merg:

Rol	Citește (listă, ghidul pentru magazine, răspunsurile de confidențialitate)	Schimbă și consumă credite (modificare, publicare, pagina din magazin)
Viewer	Da	Nu, `404`
Editor	Da	Da
Admin, owner	Da	Da

Limite

Ce	Limita
Chei API active	10 pe cont
Publicări prin API	100 pe cont pe zi
Modificări și construiri	120 pe cont pe oră
Pagini de magazin scrise	Se numără împreună cu micile acțiuni AI ale contului, 600 pe oră
Lungimea unei instrucțiuni de modificare	4.000 de caractere
Lungimea unei căutări (`q`)	100 de caractere
Aplicații returnate de o listă	100 pe pagină, cele schimbate cel mai recent primele. Vezi Listează aplicațiile tale pentru pagina următoare.
Timpul în care se poate face o modificare	Până la aproximativ 13 minute
Timpul în care se poate scrie o pagină de magazin	Până la aproximativ 2 minute

Limitele pe oră sunt un ritm, nu o alocație. Sunt acolo pentru un script care merge mai repede decât poate un om, iar cine lucrează de mână nu le atinge niciodată. Ce te limitează în practică sunt creditele tale.

Modificările sunt limitate și de creditele tale și de planul tău, exact ca în editor. Când o modificare nu poate rula din acest motiv, răspunsul este 200 cu ok: false și un error care spune de ce. Pagina din magazin este diferită: când este refuzată, nu a început încă, așa că răspunde 402.

Ce limită răspunde cum

Publicarea răspunde 429 când cele 100 ale zilei sunt folosite și 503 când limitatorul în sine nu poate fi contactat.
Pagina din magazin răspunde 429 pentru limita orei, 503 când limitatorul nu poate fi contactat și 402 pentru plan și credite.
Modificarea răspunde 200 cu ok: false, iar error poartă propoziția. Cea pe oră sună așa: You're working faster than our safety limit allows (120 an hour). You can carry on in about 12 minutes.

Propozițiile la care poate răspunde orice apel

Status	`error`
`401`	`A valid API key is required. Make one on your Setherion account page and send it as "Authorization: Bearer sth_...".`
`404`	`No such app on this account.`
`500`	`The API is not configured on this server.`

Propozițiile fiecărui apel

Listează aplicațiile tale: q is at most 100 characters. offset is a whole number, 0 or more. Could not list your apps.
Modifică o aplicație: Say what to change, in "prompt". Keep "prompt" under 4,000 characters. This app has no code yet. Build it in Setherion first, then edit it here.
Publică o aplicație: That is 100 publishes through the API today. The count resets tomorrow. Publishing is briefly unavailable. Try again in a minute. Publishing through the API is not configured on this server. și propozițiile despre secrete, adresă, aplicație privată și construire, enumerate pe pagina ei.
Pregătirea pentru magazine și Răspunsuri de confidențialitate pentru magazine: way is "easy" or "native". This app has no code yet. Build it in Setherion first.
Scrie pagina din magazin: Writing the store page is part of the Pro plan. Too many AI actions in the last hour. Try again later. și propozițiile despre credite, enumerate pe pagina ei.

Ți-a fost de folos această pagină?

Autentificare cu OAuth

Alătură-te comunității

Întrebări, idei și ce construiesc alții.