Foutcodes
Foutcodes hebben twee lagen. De buitenste code geeft het resultaat op API-niveau weer en data.bizCode het zakelijke resultaat. Een aanroep is alleen geslaagd als zowel code == 0 als data.bizCode == 0. Zie Uniforme responsstructuur.
API-foutcodes (code)
| code | Beschrijving | Advies |
|---|---|---|
| 0 | Geslaagd | — |
| 401 | Authenticatie mislukt | Zoek de precieze oorzaak in de tabel hieronder |
| 429 | Too Many Requests | Verlaag de aanroepfrequentie en probeer het opnieuw; elke API staat maximaal 10 verzoeken / seconde toe |
Oorzaken van 401
| Melding | Betekenis | Advies |
|---|---|---|
| Missing required headers | Er ontbreekt een verplichte request-header | Controleer of alle Algemene request-headers aanwezig zijn |
| Invalid timestamp format | Het formaat van de tijdstempel is onjuist | X-Timestamp moet een tijdstempel in seconden zijn |
| Request timestamp expired | De tijdstempel van het verzoek is verlopen | Synchroniseer de serverklok en verstuur het verzoek opnieuw |
| Invalid nonce format | De nonce voldoet niet aan de formaatregel | Moet overeenkomen met ^[A-Za-z0-9]{16,32}$ |
| Nonce already used or validation failed | De nonce is al gebruikt of de validatie is mislukt | Gebruik voor elk verzoek een nieuwe willekeurige tekenreeks; hergebruik deze nooit |
| appId not found | De appId bestaat niet | Controleer APP-ID |
| appId is disabled | De appId is uitgeschakeld | Neem contact op met de technische ondersteuning |
| Signature calculation failed | Het berekenen van de handtekening is mislukt | Controleer je implementatie van de handtekening; zie Handtekeningmechanisme |
| Signature verification failed | De verificatie van de handtekening is mislukt | Controleer de volgorde waarin de te ondertekenen tekenreeks is samengesteld, of path het voorvoegsel /open-apis bevat en of timestamp en nonce overeenkomen met de headers |
Zakelijke foutcodes (bizCode)
| bizCode | Beschrijving |
|---|---|
| 0 | Geslaagd |
| 10000001 | Ongeldige parameters |
| 10000003 | Te veel verzoeken. Wacht even en probeer het opnieuw |
| 10000103 | De systeemdienst werkt niet goed, neem contact op met de klantenservice |
| 100027001 | Ongeldige parameters voor creditbewerking |
| 100027003 | Onvoldoende creditsaldo |
| 100041003 | De ruimtelijke modelleringstaak bestaat niet |
| 100041004 | Resultaat van ruimtelijke modellering niet gevonden |
| 100041006 | Ruimte niet gevonden |
| 100041010 | De AppId heeft geen rechten voor ruimtelijke modellering |
| 100041016 | Taakstatus [bezig met modelleren], verwijderen is niet toegestaan |
| 100041017 | De taak kan in de huidige status niet worden geannuleerd |
Problemen met mislukt modelleren oplossen
Als een taak de status Modelleren mislukt (9) krijgt, roep dan Takenlijst met paginering of Taakdetails aan en lees errorCode en failedReason om de oorzaak te vinden.
Deze twee velden bevatten foutinformatie uit de modelleringspipeline zelf en gebruiken een andere reeks waarden dan bizCode hierboven. Als een API-aanroep slaagt maar de taak niet kan worden gemodelleerd, is bizCode nog steeds 0.