Virhekoodit

{ "error": { "code": "AIH-AUTH-0001",
             "message": "invalid login or password",
             "message_key": "err.auth.invalid_credentials",
             "details": { } } }

Jokaisessa AiHummer API -virheessä on **vakaa konekoodi** muodossa `AIH-<DOMAIN>-<NNNN>`. Johdon muoto on: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` on vakaa (ei koskaan uudelleenkäytetty tai uudelleennumeroitu); `message` on ihmisen englanninkielinen merkkijono; `message_key` on i18n-avain, jota asiakkaat käyttävät lokalisoidakseen; `details` on valinnainen jäsennetty konteksti. > Laskutus / suunnitelman oikeudet -virheet (402 "päivitys vaaditaan" -näyttö) ovat **ei** lueteltu täällä — katso [Lisensointi ja laskutus](/fi/v1.0/commercial/licensing). ## YLEINEN Poikkileikkaavia virheitä, joita jokainen palvelu jakaa (pyyntömuoto, menetelmä, tunnistus, sisäiset virheet). Aluekohtainen koodi on suositeltavaa, kun sellainen sopii. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | Menetelmää ei sallita | `err.common.method_not_allowed` | HTTP-menetelmää ei sallita tälle reitille. | | `AIH-COMMON-0002` | 400 | Virheellinen pyyntörunko | `err.common.invalid_body` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-COMMON-0003` | 400 | Vaadittu kenttä puuttuu | `err.common.missing_field` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-COMMON-0004` | 500 | Sisäinen virhe | `err.common.internal` | Odottamaton sisäinen vika. | | `AIH-COMMON-0005` | 404 | Ei löydy | `err.common.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-COMMON-0006` | 403 | Kielletty | `err.common.forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-COMMON-0007` | 501 | Ominaisuus ei ole käytössä | `err.common.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-COMMON-0008` | 401 | Luvaton | `err.common.unauthorized` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-COMMON-0009` | 400 | Varmennus epäonnistui | `err.common.validation` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-COMMON-0010` | 409 | Konflikti | `err.common.conflict` | Ristiriidassa nykyisen tilan kanssa. | | `AIH-COMMON-0011` | 429 | Rajanopeus ylittynyt | `err.common.rate_limited` | Liian monta pyyntöä / yli asetetun budjetin. | | `AIH-COMMON-0012` | 502 | Ylävirhe | `err.common.upstream` | Ylävirran/palveluntarjoajan kutsu epäonnistui. | ## TUNNUSTAUTUMINEN Järjestelmänvalvoja paikallinen todennus: kirjautuminen, istunnot, salasanan vaihto, käyttäjien hallinta, kaksivaiheinen tunnistautuminen (2FA). | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | Virheellinen kirjautuminen tai salasana | `err.auth.invalid_credentials` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-AUTH-0002` | 429 | Liian monta yritystä, yritä uudelleen myöhemmin | `err.auth.too_many_attempts` | Liian monta pyyntöä / yli asetetun budjetin. | | `AIH-AUTH-0003` | 401 | Ei todennettu | `err.auth.not_authenticated` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-AUTH-0004` | 501 | Paikallista todennusta ei ole otettu käyttöön | `err.auth.local_disabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-AUTH-0005` | 403 | Nykyinen salasana on väärä | `err.auth.wrong_current_password` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-AUTH-0006` | 409 | Et voi poistaa omaa tiliäsi | `err.auth.cannot_delete_self` | Ristiriidassa nykyisen tilan kanssa. | | `AIH-AUTH-0007` | 500 | Istuntoa ei voitu luoda | `err.auth.session_failed` | Odottamaton sisäinen vika. | | `AIH-AUTH-0008` | 501 | Kaksivaiheinen todennus ei ole käytössä | `err.auth.twofa_disabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-AUTH-0009` | 401 | Haaste vanhentunut — kirjaudu uudelleen | `err.auth.twofa_challenge_expired` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-AUTH-0010` | 401 | Virheellinen koodi | `err.auth.twofa_invalid_code` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-AUTH-0011` | 401 | Virheellinen palautuskoodi | `err.auth.twofa_invalid_recovery` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-AUTH-0012` | 401 | Toisen tekijän varmennus epäonnistui | `err.auth.twofa_verify_failed` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-AUTH-0013` | 400 | Ei rekisteröity vastaavaa toista tekijää | `err.auth.twofa_not_enrolled` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-AUTH-0014` | 400 | Virheellinen tai vanhentunut resetointitunnus | `err.auth.reset_token_invalid` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## AGENTTI AI-työntekijän (agentin) CRUD, versiot, kloonaus ja agenttikohtainen järjestelmäkehotteen profiili. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | Agentteja ei ole otettu käyttöön | `err.agent.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-AGENT-0002` | 404 | Agenttia ei löytynyt | `err.agent.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-AGENT-0003` | 403 | Ei sinun agenttisi | `err.agent.forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-AGENT-0004` | 501 | Agenttiprofiilit eivät ole käytössä | `err.agent.profile_not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-AGENT-0005` | 404 | Jaettua osiota ei löydy | `err.agent.section_not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-AGENT-0006` | 403 | Ei jaettu osiosi | `err.agent.section_forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-AGENT-0007` | 400 | Tuntematon osion tyyppi | `err.agent.unknown_section_kind` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-AGENT-0008` | 403 | Työkalu ei ole sallittu tälle agentille | `err.agent.tool_not_permitted` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-AGENT-0009` | 403 | Aliagentin syvyysraja saavutettu | `err.agent.subagent_depth_exceeded` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-AGENT-0010` | 403 | Handoff ei ole saatavilla täällä | `err.agent.handoff_unavailable` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-AGENT-0011` | 500 | Työkalun kutsu epäonnistui | `err.agent.tool_failed` | Odottamaton sisäinen vika. | | `AIH-AGENT-0012` | 400 | Handoff vaatii 'agentin' ja 'tehtävän' | `err.agent.handoff_invalid_args` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-AGENT-0013` | 404 | Ei agenttia tuolla nimellä | `err.agent.handoff_target_not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-AGENT-0014` | 400 | Ei annettu tehtäviä | `err.agent.subagent_no_tasks` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## API-AVAIN API-avaimet ohjelmalliseen porttien käyttöön: avainalijärjestelmää ei ole määritetty. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-APIKEY-0001` | 501 | API-avaimia ei ole määritetty | `err.apikey.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## HYVÄKSYNTÄ Ihmisen mukana -hyväksyntäjono: hyväksyntäominaisuus on pois päältä. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | Hyväksynnät eivät ole käytössä | `err.approval.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## ARTIFAKTI Keskustelun artefaktit (asiakirjat + suoritettava koodi): koodin suoritus pois päältä, puuttuva artefakti/versio, väärä tyyppi tai virheellinen ajonaikainen tulos. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | Koodin suorittaminen ei ole käytössä | `err.artifact.exec_disabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-ARTIFACT-0002` | 404 | Artifaktia ei löydy | `err.artifact.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-ARTIFACT-0003` | 404 | Artefaktin versiota ei löydy | `err.artifact.version_not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-ARTIFACT-0004` | 400 | Artefakti ei ole koodi | `err.artifact.not_code` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-ARTIFACT-0005` | 500 | Huono juoksijan tulos | `err.artifact.bad_runner_output` | Odottamaton sisäinen vika. | | `AIH-ARTIFACT-0006` | 400 | Lajin on oltava dokumentti tai koodi | `err.artifact.invalid_kind` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## VARMUUSKOPIO Tietokannan varmuuskopiointi hallintapinnan kautta. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-BACKUP-0001` | 501 | Tietokannan URL-osoitetta ei ole määritetty varmuuskopiota varten | `err.backup.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-BACKUP-0002` | 500 | Varmuuskopiointi epäonnistui | `err.backup.failed` | Odottamaton sisäinen vika. | ## Erä Eräpyyntöjen käsittely. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-BATCH-0001` | 501 | Erätoiminnot eivät ole käytössä | `err.batch.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-BATCH-0002` | 404 | Erää ei löytynyt | `err.batch.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | ## BUDJETTI Käytön mittaus ja mallin käyttöbudjetit. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-BUDGET-0001` | 501 | Käytön mittausta ei ole otettu käyttöön | `err.budget.usage_not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-BUDGET-0002` | 501 | Budjetteja ei ole otettu käyttöön | `err.budget.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## Tuo oma laite Tuo-oma-avain: vuokralaisen toimittamat mallin tarjoajan avaimet. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-BYOK-0001` | 501 | BYOK ei ole määritetty | `err.byok.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## MUUTA Muutostiedot ja muutos-hyväksyntätyönkulku. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-CHANGE-0001` | 404 | Muutosta ei löytynyt | `err.change.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-CHANGE-0002` | 403 | Itsehyväksyntä ei sallittu: tarvitaan toinen hyväksyjä | `err.change.self_approval_forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | ## Keskustella OpenAI-yhteensopiva chat-viimeistelyjen päätepiste. Kaapelimuoto pysyy OpenAI-yhteensopivana samalla kun siihen lisätään vakaa koodi. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | OpenAI-yhteensopiva päätepiste poistettu käytöstä | `err.chat.disabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-CHAT-0002` | 401 | Virheellinen API-avain | `err.chat.invalid_key` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-CHAT-0003` | 400 | Virheellinen chat-pyyntö | `err.chat.invalid_request` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CHAT-0004` | 429 | Taksan tai budjetin raja ylitetty | `err.chat.rate_limited` | Liian monta pyyntöä / yli asetetun budjetin. | | `AIH-CHAT-0005` | 502 | Viestin lähettäminen epäonnistui | `err.chat.turn_failed` | Ylävirran/palveluntarjoajan kutsu epäonnistui. | | `AIH-CHAT-0006` | 500 | Chatin täydennys epäonnistui | `err.chat.internal` | Odottamaton sisäinen vika. | ## YHTEYS Integraatio OAuth-yhteydet: yhdistä liput, valtuutusvaiheet ja tokenin vaihto. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-CONNECTION-0001` | 400 | Virheellinen tai vanhentunut yhdistämislippu | `err.connection.ticket_invalid` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CONNECTION-0002` | 400 | Laajennos ei ilmoita OAuth-virtausta | `err.connection.no_oauth_flow` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CONNECTION-0003` | 400 | OAuth-asiakasta ei ole määritetty tälle lisäosalle | `err.connection.oauth_client_not_configured` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CONNECTION-0004` | 400 | Valtuutus evätty | `err.connection.auth_denied` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CONNECTION-0005` | 400 | Puuttuva koodi tai tila | `err.connection.missing_code_or_state` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CONNECTION-0006` | 400 | Virheellinen tai vanhentunut tila | `err.connection.state_invalid` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CONNECTION-0007` | 400 | Laajennuksen OAuth-asetukset eivät ole saatavilla | `err.connection.oauth_config_unavailable` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-CONNECTION-0008` | 502 | Tunnuksen vaihto epäonnistui | `err.connection.token_exchange_failed` | Ylävirran/palveluntarjoajan kutsu epäonnistui. | | `AIH-CONNECTION-0009` | 500 | Ei voitu tallentaa tunnusta | `err.connection.store_token_failed` | Odottamaton sisäinen vika. | ## Todistus Käyttäjäkohtaiset tunnistetietovaraston toiminnot. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-CREDENTIAL-0001` | 501 | Todistuksien säilytyspalvelu ei ole käytössä | `err.credential.vault_not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-CREDENTIAL-0002` | 400 | Todennustietojen toimenpide epäonnistui | `err.credential.vault_error` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## LAITE Laite-silta laitteen mukana tulevaan kumppanisovellukseen. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-DEVICE-0001` | 503 | Laitteen palvelu ei ole käytettävissä | `err.device.service_unavailable` | Riippuvainen palvelu on tilapäisesti poissa käytöstä. | ## TAPAHTUMAT Palvelimen tapahtumavirta (SSE) ylläpitäjän käyttöliittymää ja asiakkaita varten. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-EVENTS-0001` | 500 | Suoratoisto ei tuettu | `err.events.streaming_unsupported` | Odottamaton sisäinen vika. | ## TOSIASIAT Pitkäaikaisen muistin tiedot käyttäjistä. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-FACT-0001` | 404 | Tietoa ei löytynyt | `err.fact.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-FACT-0002` | 403 | Ei käyttäjätieto | `err.fact.not_user_fact` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | ## KAAVIO Agenttikaaviot: deklaratiivinen moni-agentin orkestrointi. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-GRAPH-0001` | 501 | Agenttigraafit eivät ole käytössä | `err.graph.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-GRAPH-0002` | 404 | Kaaviota ei löydy | `err.graph.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-GRAPH-0003` | 403 | Ei sinun kaaviosi | `err.graph.forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-GRAPH-0004` | 501 | Graafien suoritus ei ole saatavilla tässä käyttöönottoskenaariossa | `err.graph.exec_unavailable` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## KAIDE Sisällön/ käyttäytymisen turvasääntöjä agentteja varten. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-GUARDRAIL-0001` | 501 | Suoja-aidat eivät ole määritetty | `err.guardrail.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## TULEVA Geneeriset saapuvat webhook-/ingest-päätepisteet: kanava→porttimessageiden vastaanotto. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | Luvaton | `err.inbound.unauthorized` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-INBOUND-0002` | 400 | Virheellinen saapuva tietopaketti | `err.inbound.invalid_payload` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-INBOUND-0003` | 500 | Saapuvan lähetyksen lähetys epäonnistui | `err.inbound.dispatch_failed` | Odottamaton sisäinen vika. | ## IPALLOW Ylläpitäjän käyttöoikeuden IP-sallitut luettelot. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-IPALLOW-0001` | 501 | IP-sallittujen luetteloa ei ole määritetty | `err.ipallow.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## KB Tietopohjan liittimet: RAG-ominaisuus pois päältä, tallennettu liitinmääritys vioittunut tai huono ladattu arkisto. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | Tietopohja ei ole käytössä | `err.kb.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-KB-0002` | 500 | Tallennettu asetustiedosto vioittunut | `err.kb.config_corrupt` | Odottamaton sisäinen vika. | | `AIH-KB-0003` | 400 | Virheellinen tietovarasto | `err.kb.invalid_archive` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## LISENSSI Instanssin lisensointi: allekirjoitetun lisenssin soveltaminen. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-LICENSE-0001` | 501 | Lisensointi ei ole käytössä | `err.license.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-LICENSE-0002` | 400 | Virheellinen lisenssi | `err.license.invalid` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## LLM Tuotteen sisäinen 'Connect Codex (ChatGPT-tilaus)' -laitteiden valtuutusprosessi. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex-yhteys ei ole käytettävissä: salaisten arkisto (AIHUMMER_MASTER_KEY) ei ole määritetty | `err.llm.codex_connect_disabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-LLM-0002` | 502 | Codex-laitteen valtuutusprosessia ei voitu käynnistää | `err.llm.codex_connect_start_failed` | Ylävirran/palveluntarjoajan kutsu epäonnistui. | | `AIH-LLM-0003` | 500 | Ei voitu tyhjentää tallennettua Codex-yhteyttä | `err.llm.codex_disconnect_failed` | Odottamaton sisäinen vika. | ## MARKKINA Liitännäismarkkinapaikan asennuspolku: tunnistetta (slug) tarkastetaan luettelon mukaan ennen asynkronista käyttöönottoa. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | Tuntematon moduuli: ei luettelossa | `err.marketplace.unknown_module` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | ## MEDIA Mediablobin hakemis-/striimauspäätepisteet: allekirjoitetun tokenin mediatuki. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | Mediaa ei löytynyt | `err.media.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-MEDIA-0002` | 403 | Virheellinen tai vanhentunut mediatunnus | `err.media.token_invalid` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-MEDIA-0003` | 503 | Videon ymmärtäminen ei ole määritetty | `err.media.video_not_configured` | Riippuvainen palvelu on tilapäisesti poissa käytöstä. | ## MUISTI Pitkän aikavälin muisti (Einstein) hallintapinta: muistin tausta ei ole kytketty. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | Muistia ei ole määritetty | `err.memory.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## MALLINPÄÄSY Mallin käyttöoikeussäännöt (mitkä mallit ovat saatavilla mille käyttäjille/agentille). | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-MODELACCESS-0001` | 501 | Mallin käyttöä ei ole määritetty | `err.modelaccess.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## MODUULI Liitännäinen/moduulien markkinapaikan ohjauspinta: ominaisuus pois päältä, puuttuva lähde/asennus, omistajuus tai virheellisesti ladattu sivulataus. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | Markkinapaikka ei ole käytössä | `err.module.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-MODULE-0002` | 404 | Lähdettä ei löydy | `err.module.source_not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-MODULE-0003` | 404 | Asennusta ei löydy | `err.module.installation_not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-MODULE-0004` | 403 | Ei sinun asennuksesi | `err.module.installation_forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-MODULE-0005` | 501 | Laajennuksen lataus poistettu käytöstä (ei blob-varastoa) | `err.module.upload_disabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-MODULE-0006` | 400 | Virheellinen lisäosan latauspaketti | `err.module.invalid_bundle` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## PARITTAMINEN Laitteen paritus (QR-koodin lunastus), laitteen istunnon vahvistus, sitomisen tila. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | Parikoodia vaaditaan | `err.pairing.code_required` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-PAIRING-0002` | 401 | Virheellinen tai vanhentunut parikoodi | `err.pairing.invalid_code` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-PAIRING-0003` | 401 | Huono saapuva salaisuus | `err.pairing.bad_inbound_secret` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-PAIRING-0004` | 400 | Vaadittu kenttä puuttuu | `err.pairing.field_required` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | | `AIH-PAIRING-0005` | 401 | Virheellinen tai vanhentunut istunto | `err.pairing.session_invalid` | Puuttuvat tai virheelliset tunnistetiedot. | | `AIH-PAIRING-0006` | 400 | Merkkijono vaaditaan | `err.pairing.token_required` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## LEIKKIPAIKKA Kehote/mallin leikkikenttä. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-PLAYGROUND-0001` | 501 | Leikkikenttä ei ole käytössä | `err.playground.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## KEHOTUS Kehote-/mallikirjasto. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-PROMPT-0001` | 501 | Kehotekirjasto ei ole määritetty | `err.prompt.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-PROMPT-0002` | 404 | Mallia ei löytynyt | `err.prompt.template_not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | ## TYÖNNÄ Mobiilisovelluksen push-ilmoitukset toimittajan push-välityksen kautta (instanssilla ei ole toimittajan tunnuksia). | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-PUSH-0001` | 503 | Push-rele ei saatavilla (myyjän push-palvelu ei saatavilla / instanssia ei rekisteröity) | `err.push.relay_unavailable` | Riippuvainen palvelu on tilapäisesti poissa käytöstä. | | `AIH-PUSH-0002` | 502 | Push-releen toimitus epäonnistui | `err.push.relay_failed` | Ylävirran/palveluntarjoajan kutsu epäonnistui. | ## SATEEN Vastauksen uudelleenluonti (uudelleenluo). | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-REGEN-0001` | 501 | Uudelleenluonti ei ole käytössä | `err.regen.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## SAML SAML-yksi kirjautuminen. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SAML-0001` | 501 | SAML ei ole saatavilla | `err.saml.not_available` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-SAML-0002` | 400 | Väitteellä puuttuu subjekti | `err.saml.assertion_invalid` | Väärin muodostettu, puutteellinen tai virheellinen pyyntösyöte. | ## AIKATAULU Ajoitetut/viivästetyt viestin lähetykset. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SCHEDULE-0001` | 404 | Aikataulua ei löytynyt | `err.schedule.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | ## SCIM SCIM-käyttäjien provisiointi. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SCIM-0001` | 501 | SCIM ei ole käytössä | `err.scim.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## SALAINEN Henkilökohtaisten vuokralaisten salainen holvi: pääavain puuttuu tai nimetty salaisuus ei ole olemassa. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | Salaisuudet eivät ole määritetty | `err.secret.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-SECRET-0002` | 404 | Salaisuutta ei löydy | `err.secret.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | ## Tunne Keskusteluanalytiikka: tunteet ja laatu. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SENTIMENT-0001` | 501 | Keskusteluanalytiikka ei ole käytössä | `err.sentiment.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-SENTIMENT-0002` | 404 | Ei vielä analysoitu | `err.sentiment.not_analyzed` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-SENTIMENT-0003` | 422 | Ei voitu analysoida keskustelua | `err.sentiment.unprocessable` | Pyyntö on voimassa, mutta sisältöä ei voitu käsitellä. | ## ISTUNTO Keskustelu/istunto + viestinhallinnan käyttöliittymä: ominaisuus pois päältä, tai keskustelu/viesti ei kuulu kutsujalle. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | Keskusteluja ei ole käytössä | `err.session.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-SESSION-0002` | 403 | Ei sinun keskustelusi | `err.session.conversation_forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | | `AIH-SESSION-0003` | 403 | Ei sinun viestisi | `err.session.message_forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | ## TAITO Aineksen taidot: kirjasto ja omistajuus. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SKILL-0001` | 501 | Taitoja ei ole otettu käyttöön | `err.skill.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-SKILL-0002` | 404 | Taitoa ei löydy | `err.skill.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-SKILL-0003` | 403 | Ei sinun taitosi | `err.skill.forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | ## SKILLOPT Taitojen optimointityökalu: taitojen parantamisehdotuksia. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SKILLOPT-0001` | 501 | Taitojen optimointia ei ole otettu käyttöön | `err.skillopt.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-SKILLOPT-0002` | 404 | Ehdotusta ei löydy | `err.skillopt.proposal_not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | | `AIH-SKILLOPT-0003` | 403 | Ei sinun ehdotuksesi | `err.skillopt.proposal_forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | ## JÄRJESTELMÄ Isäntäjärjestelmän toiminnot: lokit ja itsepäivitys. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-SYSTEM-0001` | 501 | Lokit eivät ole saatavilla tällä isännällä | `err.system.logs_unavailable` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-SYSTEM-0002` | 501 | Itsepäivitys ei ole määritetty; suorita `sudo aihummer update` isännällä | `err.system.update_not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | ## KÄYTTÄJÄ Työtila käyttäjän ja roolien hallinta. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-USER-0001` | 409 | Et voi muuttaa omia roolejasi | `err.user.cannot_change_own_roles` | Ristiriidassa nykyisen tilan kanssa. | | `AIH-USER-0002` | 409 | Ei voi poistaa viimeistä omistajaa | `err.user.cannot_remove_last_owner` | Ristiriidassa nykyisen tilan kanssa. | ## ÄÄNI Puheenvuoron päätepiste (/v1/voice/turn): SIP-silta → porttiäänenvuoron pinta. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | Ei voitu ratkaista keskustelua | `err.voice.resolve_failed` | Ylävirran/palveluntarjoajan kutsu epäonnistui. | | `AIH-VOICE-0002` | 502 | Äänensiirto epäonnistui | `err.voice.turn_failed` | Ylävirran/palveluntarjoajan kutsu epäonnistui. | ## WEBCONN Admin Sessions -taustajärjestelmä: selainistunto ja SSE-keskustelu. SSE-virran virhetapahtumat eivät kuulu tähän virhemuotoon. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | Keskustelu ei kuulu istuntoosi | `err.webconn.forbidden` | Resurssi kuuluu toiselle vuokraajalle, omistajalle tai istunnolle. | | `AIH-WEBCONN-0002` | 500 | Suoratoistoa ei tueta | `err.webconn.streaming_unsupported` | Tapahtui odottamaton virhe. | ## WEBHOOK Lähtevät webhookit instanssitapahtumille. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-WEBHOOK-0001` | 501 | Verkkokoukut eivät ole käytössä | `err.webhook.not_enabled` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-WEBHOOK-0002` | 404 | Webhookia ei löytynyt | `err.webhook.not_found` | Viitattu objekti ei ole olemassa tai se on laajuuden ulkopuolella. | ## TYÖTILA Työtilan omistajuus/rajaus: toimiva vuokralainen toimi työtilassa, jota se ei omista. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | Ei sinun työtilaasi | `err.workspace.forbidden` | Resurssi kuuluu toiselle vuokralaiselle/omistajalle/istunnolle. | ## ZAPIER Zapierin liittimen saapuva laukaisin. | Koodi | HTTP | Merkitys | i18n-avain | Tyypillinen syy | | --- | --- | --- | --- | --- | | `AIH-ZAPIER-0001` | 501 | Sisääntulevaa liipaisinta ei ole määritetty | `err.zapier.not_configured` | Ominaisuus/integratio on pois päältä tai määrittelemätön. | | `AIH-ZAPIER-0002` | 401 | Virheellinen laukaisevan signaali tai tunniste | `err.zapier.invalid_signature` | Puuttuvat tai virheelliset tunnistetiedot. |