FAQ für Mobile-App-Entwickler #

Kurze Antworten auf die Fragen, die App-Entwickler am häufigsten stellen. Jede Antwort verweist auf die Seite, die sie erklärt.

Inhalt #

1. Verbinden
2. Inhalte lesen
3. Inhalte schreiben
4. Plattform und Werkzeuge

Verbinden #

Meine Anfrage antwortet mit 401 und leerem Inhalt. Warum? Keine gültigen Zugangsdaten haben PHP erreicht. Ohne sie antwortet die REST-API mit 401, dem Header WWW-Authenticate: OAuth realm='Exponential REST' und ohne Inhalt (beobachtet auf dem Demonstrationsserver). Prüfen Sie Namen und Schema des Headers und ob ein Proxy Authorization verwirft (Der Authorization-Header und Proxys).

Soll meine App v1 oder v2 aufrufen? Lesezugriffe antworten in beiden gleich; Schreibzugriffe gibt es nur in v2. Neue Apps können durchgehend v2 verwenden (API-Versionen v1 und v2).

Unterstützt der OAuth-Server PKCE oder öffentliche Clients? Nein. Der Token-Endpunkt verlangt client_secret und unterstützt nur die Grants authorization_code und refresh_token. Halten Sie das Secret auf einem Server (Ein Backend für Ihre App).

Kann ich einen persönlichen API-Schlüssel in meiner App ausliefern? Nein. Ein Schlüssel gehört einem Benutzer, handelt als dieser Benutzer und ist für dessen eigene Skripte gedacht. Jeder, der die App entpackt, hätte ihn (Persönliche API-Schlüssel für Werkzeuge).

Bekommt die App den Parameter state von der Autorisierungsseite zurück? Nein. Die View authorize sagt „state, not implemented yet“. Ordnen Sie die Weiterleitung selbst zu (OAuth2-Autorisierungscode-Ablauf).

Wie lange lebt ein Token? rest.ini [OAuthSettings] TokenTTL, standardmäßig eine Stunde; die Token-Antwort nennt den Wert in expires_in (OAuth2-Autorisierungscode-Ablauf).

Inhalte lesen #

Wo ist Knoten 2, und bei welchem Knoten soll meine App beginnen? Knoten 2 ist in einer Standardinstallation die Wurzel des Inhaltsbaums. Fragen Sie die Redakteure nach dem Ordner, den Ihre App zeigt, und verwenden Sie lieber seine Remote-ID als seine Nummer (Knoten-IDs, Remote-IDs und Deep Links).

Warum liefert eine Liste nur zehn Elemente? Das Standardlimit der Route list ist 10. Ergänzen Sie /offset/<n>/limit/<n> (Unterknoten auflisten und Paginierung).

Warum fehlen meine Felder in der Liste? Listen liefern nur Metadaten, außer Sie ergänzen ?ResponseGroups=Fields (Antwortgruppen).

Wie bekomme ich ein Bild in der Größe meines Bildschirms? REST liefert nur den Pfad der Originaldatei. Fordern Sie mit expimage::url eine Alias-URL an (Bildaliase für Bildschirmgrößen).

Gibt es eine Suchroute? Nicht in REST. Die Remote-Dienste haben expsearch::search (Inhalte suchen).

Wie lese ich eine andere Sprache? Ergänzen Sie ?Translation=<locale> (zum Beispiel ger-DE) bei Lesezugriffen auf Knoten, Objekte und Felder (Mehrsprachige Inhalte).

Mein Artikeltext hat seine Formatierung verloren. Rich-Text-Felder werden in REST-Antworten als reiner Text geliefert. Siehe Rich Text in Apps.

Inhalte schreiben #

Kann die App ein vorhandenes Element über REST aktualisieren? Noch nicht: Die Aktualisierungsroute prüft content/edit und antwortet dann mit 501. Verwenden Sie expnode::update (Über expservices schreiben).

Mein Anlegen antwortet mit 400. languageLocale fehlt, oder parentNodeID oder classIdentifier fehlt oder ist unbekannt (Inhalte anlegen und entfernen).

Können Benutzer aus der App Fotos hochladen? Keine dokumentierte Route nimmt eine Datei von einem Gerät entgegen (Dateien und Uploads).

Plattform und Werkzeuge #

Gibt es ein SDK? Nein. Es gibt Shell- und Python-Clients für expservices und handgeschriebene Client-Beispiele für andere Plattformen (Mobile-App-Entwickler: hier beginnen).

Ist expsite_app ein Framework für mobile Apps? Nein. Es ist der Ort für die Design-Overrides und Einstellungen eines Website-Projekts, über das Design simple gelegt (laut seinem README.md).

Meine Browser-App bekommt einen CORS-Fehler. Exponential sendet keine CORS-Header. Liefern Sie die App vom selben Origin aus oder setzen Sie die Header im Webserver (Web-Apps, CORS und CSP).

Wo teste ich, ohne eine echte Website zu beschädigen? Am besten in einer eigenen lokalen Installation; auf einer öffentlichen Demo ist möglicherweise nicht jede API aktiv (Testen).

Wo frage ich nach oder melde etwas? Auf der Seite Fehler melden der Hilfe und unter Wenn etwas schiefgeht; die FAQ für die Serverseite ist Anwendungsentwickler: häufig gestellte Fragen.

Verwandte Seiten #

• Mobile-App-Entwickler: hier beginnen
• Was die APIs nicht können
• Glossar für Mobile-App-Entwickler
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.