Prüfen Sie bei ARIX sowohl den HTTP-Transport als auch den Antwortinhalt. Eine erfolgreiche HTTP-Verbindung bedeutet nicht, dass der angeforderte API-Aufruf erfolgreich war.
Antwort prüfen
- Transportfehler und HTTP-Status erfassen.
- Eine leere Antwort nicht als Erfolg behandeln.
- Das für den Befehl vereinbarte Format prüfen: normalerweise XML, bei
search count="1"eine Textzahl; bestimmte Lizenzoperationen können mehrere oberste XML-Elemente liefern. - Bei XML auf
errorprüfen, auch wenn der HTTP-Status 200 lautet. - Bei Erfolg die für den Befehl erwarteten Elemente und Attribute prüfen.
Eine HTML-Fehlerseite ist keine ARIX-Ergebnisliste. XML sicher parsen, externe Entitäten und Netzwerkzugriffe deaktivieren. Antwortgröße und Wartezeit auf Clientseite begrenzen.
Häufige Meldungen
| Meldung oder Antwort | Ursache und Prüfung |
|---|---|
Welcome to ARI/[X|ON]-Interface … |
Der Einstieg hat kein Formularfeld xmlstatement erhalten. Nicht nur rohes XML als Body senden. |
Interface without context called! |
Kein nutzbarer Kontext übergeben. URL und optionales Formularfeld context kontrollieren. |
Sorry, interface … not allowed for … |
Befehl für den erkannten Zugang nicht erlaubt. Root-Tag, tatsächliche Quell-IP und Kontextfreigabe prüfen lassen. |
Interface … not defined! |
Kein passender Handler gefunden. Schreibweise und vereinbarten Funktionsumfang prüfen. |
No valid licence or no record for … |
Medium fehlt oder ist für Kontext/Rolle nicht lizenziert. Identifier und Testberechtigung abgleichen. |
ID MISSING! |
Notch-ID fehlt. Das id-Attribut der Challenge übernehmen. |
Wrong notch-type! |
Challenge gehört zu einer anderen Operation. Passenden Typ neu anfordern. |
Notch expired! |
Challenge ist zu alt. Neue Challenge erzeugen und unmittelbar verwenden. |
Wrong passphrase for … |
Nonce, Secret oder Hashbildung stimmen nicht. MD5(NONCE + ":" + SECRET) prüfen. |
Different context used for tmpuser! |
Temporärer Login und Folgeaufruf verwenden unterschiedliche Kontexte. |
Different IP used for tmpuser! |
Ausgehende IP hat sich zwischen Login und Folgeaufruf geändert. NAT/Proxy-Ausgang prüfen. |
<login allow="no"/> |
Benutzerprüfung fehlgeschlagen; das ist kein error-Element. |
Unknown type … |
Taxonomietyp nicht freigegeben oder nicht eingerichtet. |
SQL ERROR als Text statt XML |
Die Anfrage konnte nicht verarbeitet werden. Bei einer Suche mit WORD/BEGIN dieselbe Anfrage ohne option zum Vergleich prüfen und unseren Support kontaktieren. Das ist kein leeres Suchergebnis; die Suchsemantik nicht stillschweigend ändern. |
Licence interface not configured. No if_licence. |
Lizenzverwaltung ist für den Kontext nicht eingerichtet. |
Die Tabelle ist keine vollständige Liste aller Backendfehler. Meldungen können Identifier oder IP-Adressen enthalten. Vor Weitergabe bereinigen.
Ungültiges XML und HTTP 404
Nicht wohlgeformtes XML kann eine generische HTML-Fehlerseite mit HTTP 404 auslösen. Das beweist nicht, dass die ARIX-Adresse falsch ist. Zuerst das tatsächlich übertragene und URL-dekodierte xmlstatement prüfen:
- Stimmen öffnende und schließende Tags überein? Der Befehl heißt
licence, nichtlicense. - Sind Attributwerte in Anführungszeichen eingeschlossen?
- Sind
&und<in Nutzdaten korrekt escaped? - Wurde der Request abgeschnitten oder versehentlich doppelt kodiert?
curl --data-urlencode übernimmt die Formularkodierung, aber nicht das XML-Escaping innerhalb eines selbst zusammengesetzten Dokuments. Für variable Werte einen XML-Serializer verwenden.
Leere oder abweichende Ergebnisse
Ein leeres Suchergebnis kann korrekt sein. Prüfen Sie Kontext, Rolle, Suchfelder und Suchmodus. Bei WORD/BEGIN können kurze Begriffe und Stoppwörter fehlen. Ein anderer Zugang kann andere Datenquellen und Lizenzen besitzen.
Fehlende Metadatenfelder sind nicht automatisch ein Parserfehler. search lässt leere Werte aus. Ebenso sind fehlende Downloadlinks nicht automatisch Authentifizierungsfehler: Rolle, Medientyp und Downloadregeln können sie ausschließen.
Bei Paging die Verfahren nicht vermischen: search besitzt im regulären Handler kein resume; harvest verwendet more und kann den zusätzlichen Prüfdatensatz mitliefern.
Wiederholungen und Support
Lesende Requests nach vorübergehenden Transportfehlern mit begrenzten Wiederholungen und Wartezeit erneut versuchen. Abgelaufene Challenges nicht wiederverwenden. Schreibende Lizenzrequests nach unklarem Ausgang zuerst durch einen Leseaufruf abgleichen.
Für unseren Support genügen in der Regel Zeitpunkt mit Zeitzone, Befehl, HTTP-Status, bereinigte Fehlermeldung und ein anonymisiertes Requestbeispiel. Kontext und Identifier nur über unseren dafür vorgesehenen Supportkanal teilen. Secrets, temporäre Passwörter, Passphrases und vollständige Medienlinks nicht in Tickets oder Logs übernehmen.
Zur Übersicht: Einstieg in die ARIX-Schnittstelle