Image API
Image API v4 bietet umfassende Funktionen für die Bild-API und unterstützt insbesondere den OPPO Bild-Upload.
Aufrufvalidierung
Weitere Details finden Sie in der Beschreibung der REST API-Übersicht unter Authentifizierungsmethode.
OPPO Bild-Upload
API-Anfrage: Aufrufadresse
POST v4/image/oppo
POST v4/image/oppo
Diesen Codeblock im schwebenden Fenster anzeigen
Beispiel für eine API-Anfrage
Request Header
> POST /v4/image/oppo HTTP/1.1
> Authorization: Basic Yzk2ZjQyZTBkMmU2NjJlNDVkMDM1YWIxOmRmNGQ1OWU4NGVhYzJmOWQ1M2IzNmYxMg==
> POST /v4/image/oppo HTTP/1.1
> Authorization: Basic Yzk2ZjQyZTBkMmU2NjJlNDVkMDM1YWIxOmRmNGQ1OWU4NGVhYzJmOWQ1M2IzNmYxMg==
Diesen Codeblock im schwebenden Fenster anzeigen
Request Body
{
"big_picture_url" : "",
"small_picture_url": ""
}
{
"big_picture_url" : "",
"small_picture_url": ""
}
Diesen Codeblock im schwebenden Fenster anzeigen
Anfrageparameter
| Schlüsselwort | Typ | Option | Bedeutung |
|---|---|---|---|
| big_picture_url | String | Optional | URL des großen Bildes. OPPO-Anforderung: Größe 984×369 px, Dateigröße max. 1 MB, Formate PNG/JPG/JPEG. |
| small_picture_url | String | Optional | URL des kleinen Icons. OPPO-Anforderung: Größe 144×144 px, Dateigröße max. 50 KB, Formate PNG/JPG/JPEG. |
Rückgabeparameter
| Schlüsselwort | Typ | Option | Bedeutung |
|---|---|---|---|
| big_picture_id | String | Optional | ID für das große Bild |
| small_picture_id | String | Optional | ID für das kleine Icon |
Rückgabebeispiel
Erfolgreiche Antwort
< HTTP/1.1 200 OK
< Content-Type: application/json
{
"big_picture_id": "",
"small_picture_id": ""
}
< HTTP/1.1 200 OK
< Content-Type: application/json
{
"big_picture_id": "",
"small_picture_id": ""
}
Diesen Codeblock im schwebenden Fenster anzeigen
Fehlerantwort
{
"error": {
"code": 21003,
"message": "Parameterwert ist ungültig"
}
}
{
"error": {
"code": 21003,
"message": "Parameterwert ist ungültig"
}
}
Diesen Codeblock im schwebenden Fenster anzeigen
Rückgabewerte
HTTP-Status-Code
Weitere Informationen: HTTP-Status-Code
Fehlercodes
| Code | Beschreibung | Erklärung | HTTP-Status-Code |
|---|---|---|---|
| 0 | Erfolg | Erfolgreich | 200 |
| 21001 | Methode wird nicht unterstützt oder URL-Fehler | Falsche Anfragemethode (GET/POST) oder falsche URL (Schnittstelle existiert nicht) | 404 |
| 21003 | Parameterwert ist ungültig | Ungültiger Parameterwert | 400 |
| 23001 | Basis-Authentifizierung fehlgeschlagen | HTTP Basic-Authentifizierung fehlgeschlagen | 401 |
| 23002 | Fehlender Parameter! | Erforderlicher Parameter fehlt | 400 |
| 23100 | Serverfehler | Interner Systemfehler | 500 |
| 27000 | Server-Antwortzeit überschritten, bitte später versuchen | Interner Systemfehler | 500 |
| 51 | Bildgröße überschreitet das Limit | OPPO-Fehler: Das Bild überschreitet normalerweise das Limit. Bitte versuchen Sie es mit einem anderen Bild. | 200 |
