OpenAPIOpenAPI
  • English
  • 繁體中文
  • Indonesia
  • हिंदी
  • Русский
  • Tiếng Việt
  • German
  • português
  • English
  • 繁體中文
  • Indonesia
  • हिंदी
  • Русский
  • Tiếng Việt
  • German
  • português
  • 911Proxy OpenAPI

911Proxy OpenAPI

app_key Der Authentifizierungsschlüssel kann nach dem Einloggen auf der Homepage des persönlichen Zentrums eingesehen werden.

Bitte bewahren Sie den Schlüssel sicher auf, der Schlüssel besitzt die Administratorrechte für Ihr Konto.

Basis-URLs:

https://api.911proxy.com

Authentifizierungsmethode

App-Key-Authentifizierung

POST-Parameter:

app_key: {your_app_key}

Oder als Abfrageparameter:

?app_key={your_app_key}

Antwortformat

Alle Schnittstellen geben ein einheitliches JSON-Format zurück:

{
	"code": 200,
	"message": "操作成功",
	"data": {}
}
  • code: Statuscode, 200 bedeutet Erfolg, andere Werte bedeuten Fehler
  • message: Antwortnachricht (Chinesisch)
  • data: Antwortdaten

Authentifizierung

Diese Schnittstelle unterstützt die folgenden zwei Authentifizierungsmethoden:

1. Bearer Token(JWT)

Übertragung des Tokens im HTTP-Header.

Header-Beispiel:

Authorization: Bearer <your_jwt_token>

API-Schlüssel-Authentifizierung

Diese Schnittstelle verwendet die API Key-Methode zur Authentifizierung.

Der Client muss den Parameter app_key in der Anfrage übermitteln, andernfalls wird die Anfrage abgelehnt.

Beispiel:

GET /api/example?app_key=your_app_key

POST /api/example?app_key=your_app_key
Content-Type: application/json

Verwaltung von Proxy-Konten

GET Liste der Proxy-Konten

GET /api-gate-way/whitelist-account/list

Beispiel für die Rückgabe

Erfolgreiche Antwort (200)

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"username": "string",
				"password": "string",
				"created_at": "string",
				"remark": "string",
				"product_type": 9,
				"usage_flow": 0,
				"limit_flow": 102400,
				"status": 0
			}
		]
	}
}

Rückgabeergebnis

StatuscodesBedeutung der StatuscodesErläuterungDatenmodell
200OKAnfrage erfolgreichInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» coderesponseCodefalschkeineStatuscode, 200 Erfolgreich, 3 app_key ungültig
» msgZeichenketteFalschKeineStatusmeldung
» DatenObjektfalschkeinekeine
»» Liste[Objekt]falschkeinekeine
»»» idintegerfalschkeineKontonummer
»»» BenutzernameZeichenketteFalschKeineName des Proxy-Kontos
»»» PasswortZeichenfolgefalschkeinePasswort des Agentenkontos
»»» erstellt_amstringFalschkeineHinzugefügt am
»»» BemerkungZeichenfolgefalschkeineAnmerkungen
»»» ProduktartProduktartenfalschkeinePakettyp, 9 dynamische Wohn-Traffic-Pakete, 11 dynamische Wohn-IPs, 14 statische Rechenzentrums-IPs, 25 statische Wohn-IPs
»»» usage_flowintegerFalschKeineVerbrauchter Traffic, Einheit: KB
»»» limit_flowintegerFalschkeineBenutzerdefinierte Datenobergrenze: Einheit GB, maximal 102400, 0 für unbegrenzt
»»» statusGanzzahlfalschkeineAktivierungsstatus: 1 Aktiviert, 0 Deaktiviert

Enumerationswerte

AttributWert
product_type9
product_type11
Produktart14
Produktart25

POST Agentenkonto hinzufügen

POST /api-gate-way/whitelist-account/add

Body-Anfrageparameter

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01:pass,user02:pass,user03:pass",
	"remark": "",
	"product_type": 9
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodyKörperObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlüssel
» accountsbodystringNeinKontopasswort, bitte im Format Benutzername:Passwort ausfüllen. Benutzername und Passwort unterstützen nur Zahlen und Buchstaben. Die Eingabe von Sonderzeichen oder Leerzeichen ist nicht zulässig. Doppelpunkt trennt Benutzername und Passwort. Die Batch-Hinzufügung wird unterstützt, wobei englische Kommas (,) die Proxy-Konten trennen.
» BemerkungbodystringNeinBeschreibung des Proxy-Kontos
» product_typebodyproductTypesNeinPakettyp, 9 Dynamisches Wohn-Traffic-Paket, 11 Dynamische Wohn-IP, 14 Statische Rechenzentrums-IP, 25 Statische Wohn-IP

Enumerationswert

AttributWert
» product_type9
» Produktart11
» Produktart14
» Produktart25

Rückgabebeispiel

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": null
}

Rückgabeergebnis

StatuscodeBedeutung des StatuscodesAnleitungDatenmodell
200OKAnfrage erfolgreichInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht mit echtem Namen authentifiziert
» msgstringFalschkeineStatusmeldung
» datanullfalschkeinekeine

POST Proxy-Konto löschen

POST /api-gate-way/whitelist-account/delete

Bitte beachten Sie, dass die Löschung nicht rückgängig gemacht werden kann und der verbrauchte Traffic usw. nicht abgefragt werden kann. Das Löschen dauert etwa 5 Minuten. Während dieser Zeit können weiterhin Kosten entstehen.

Body-Anfrageparameter

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» app_keyTextkörperstringNeinAutorisierungsschlüssel
» accountsbodystringNeinProxy-Konto, unterstützt nur Zahlen und Buchstaben. Unterstützt Batch-Betrieb, englische Kommas (,) trennen Proxy-Konten

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": null
}

Ergebnis zurückgeben

StatuscodeStatuscode-BedeutungErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschkeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht mit echtem Namen authentifiziert
» msgstringfalschkeineStatusmeldung
» DatennullFalschKeineKeine

POST Proxy-Konto deaktivieren

POST /api-gate-way/whitelist-account/disable

Die Deaktivierung dauert etwa 5 Minuten. Während dieser Zeit können weiterhin Gebühren anfallen.

Body-Anfrageparameter

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlüssel
» KontenbodystringNeinProxy-Konto, unterstützt nur Ziffern und Buchstaben. Unterstützt Batch-Operationen, Proxy-Konten werden durch englische Kommas (,) getrennt.

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": null
}

Rückgabeergebnis

StatuscodesBedeutung der StatuscodesErläuterungDatenmodell
200OKAnfrage erfolgreichInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerfalschkeineStatuscode, 200 Erfolgreich, 3 ungültiger app_key, 156 Konto nicht mit echtem Namen authentifiziert
» msgZeichenketteFalschKeineStatusmeldung
» DatennullFalschKeinekeine

POST Proxy-Konto aktivieren

POST /api-gate-way/whitelist-account/enable

Body Anforderungsparameter

{
	"app_key": "stringstringstringstringstringst",
	"accounts": "user01,user02"
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlüssel
» KontenbodystringNeinProxy-Konto, unterstützt nur Ziffern und Buchstaben. Unterstützt Batch-Operationen, Proxy-Konten werden durch englische Kommas (,) getrennt.

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": null
}

Rückgabeergebnis

StatuscodesBedeutung der StatuscodesBeschreibungDatenmodell
200OKAnfrage sendenInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerfalschkeineStatuscode, 200 Erfolgreich, 3 ungültiger app_key, 156 Konto nicht persönlich identifiziert
» msgZeichenketteFalschKeineStatusmeldung
» DatennullFalschKeinekeine

POST Proxy-Konto-Passwort ändern

POST /api-gate-way/whitelist-account/change-password

Bitte beachten Sie, dass nach der Änderung eine Wartezeit von 5 Minuten besteht, in der das alte Passwort weiterhin normal verwendet werden kann.

Body-Anfrageparameter

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"password": "pass"
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodyKörperObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlüssel
» KontobodystringNeinProxy-Konto, unterstützt nur Ziffern und Buchstaben.
» PasswortbodyZeichenfolgeNeinNeues Passwort für das Proxy-Konto, unterstützt nur Zahlen und Buchstaben.

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": null
}

Rückgabeergebnis

StatuscodeBedeutung des StatuscodesErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht mit echtem Namen authentifiziert
» msgstringFalschkeineStatusmeldung
» Datennullfalschkeinekeine

POST-Anfrage zum Ändern der Notiz des Proxy-Kontos

POST /api-gate-way/whitelist-account/change-remark

Body-Anforderungsparameter

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"remark": ""
}

Anforderungsparameter

NamePositionTypErforderlichBeschreibung
KörperKörperObjektNeinkeine
» app_keybodystringNeinAutorisierungsschlüssel
» KontobodyZeichenketteNeinProxy-Konto, unterstützt nur Zahlen und Buchstaben.
» remarkbodystringNeinNeue Notiz für das Proxy-Konto, maximal 32 chinesische Zeichen oder 64 englische Zeichen.

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": null
}

Ergebnis zurückgeben

StatuscodeStatuscode-BedeutungErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschkeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht identifiziert
» msgstringfalschkeineStatusmeldung
» DatennullFalschKeineKeine

POST zum Ändern des Datenverkehrslimits für ein Proxy-Konto

POST /api-gate-way/whitelist-account/change-limit

Bitte beachten Sie, dass die Datenverkehrsstatistik eine Verzögerung von bis zu 5 Minuten aufweisen kann, d. h. der tatsächliche Datenverkehrsverbrauch kann dieses Limit überschreiten.

Body-Anforderungsparameter

{
	"app_key": "stringstringstringstringstringst",
	"account": "user",
	"limit": 0
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlüssel
» KontobodystringNeinAgentenkonto, unterstützt nur Ziffern und Buchstaben.
» limitbodyintegerNeinTraffic-Limit, Einheit: GB, 0 für unbegrenzt

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": null
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatennullFalschkeinekeine

Abfrage von Traffic-Protokollen

GET-Nutzung des Datenverkehrs nach Tagen zusammengefasst

GET /api-gate-way/user-usage-flow/total

Anfrageparameter

NamePositionTypErforderlichBeschreibung
App-KeyqueryString(Passwort)JaAuthentifizierungsschlüssel
StartzeitAbfrageString(J-m-d H:i:s)NeinStartzeit, mit einer Genauigkeit bis auf die Sekunde. Bitte beachten Sie, dass die Protokollierung eine Verzögerung von bis zu 5 Minuten aufweisen kann. Standardmäßig innerhalb von 7 Tagen.
end_timeAbfragestring(Y-m-d H:i:s)NeinFrist, die bis auf die Sekunde genau sein kann. Bitte beachten Sie, dass es bei der Protokollierung zu einer Verzögerung von bis zu 5 Minuten kommen kann. Standardmäßig ist die aktuelle Zeit eingestellt.
NutzernameAbfragestringNeinName des Unterkontos. Standardmäßig werden alle Konten abgefragt. Sie können ein bestimmtes Unterkonto angeben. Bitte beachten Sie: Wenn Sie Unterkonten mit demselben Namen hinzugefügt haben, gibt diese Abfrage alle Nutzungsdatensätze der Proxy-Konten mit demselben Namen zurück.
ProduktartAbfrageAnzahlNeinPakettyp

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"day": "2022-08-01",
				"flow": 0
			}
		]
	}
}

Rückgabeergebnis

StatuscodesBedeutung der StatuscodesBeschreibungDatenmodell
200OKAnfrage erfolgreichInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerfalschkeineStatuscode, 200 Erfolgreich, 3 ungültiger app_key, 156 Konto nicht persönlich identifiziert
» msgZeichenketteFalschKeineStatusmeldung
» DatenObjektfalschkeinekeine
»» Liste[Objekt]falschkeinekeine
»»» TagZeichenfolgefalschkeineDatum
»»» FlussintegerFalschKeineVerbrauchter Traffic, Einheit KB

Paketabfrage

GET Liste der gekauften Pakete

GET /api-gate-way/user-product/list

Anfrageparameter

NamePositionTypErforderlichBeschreibung
App-KeyqueryString(Passwort)JaAuthentifizierungsschlüssel
trade_noAbfragestringNeinBestellnummer, bitte geben Sie die vollständige Bestellnummer ein. Fuzzy-Suche wird nicht unterstützt.
SeiteAbfrageAnzahlNeinSeitenzahl, Standard: 1
GrößeAbfrageAnzahlNeinAnzahl der Elemente pro Seite, Standard: 20
ProduktartAbfrageAnzahlNeinPakettyp

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"id": 0,
				"created_at": "2022-05-13 12:14:15",
				"expired_at": "2022-05-13 12:14:15",
				"product_type": 9,
				"trade_no": "2022051312134339861461465434",
				"order": {
					"created_at": "2022-05-13 12:13:43",
					"pay_at": "2022-05-13 12:13:43",
					"title": "入门级"
				}
			}
		],
		"page": 1,
		"page_size": 20,
		"total_count": 0,
		"total_page": 0
	}
}

Rückgabeergebnis

StatuscodesBedeutung der StatuscodesBeschreibungDatenmodell
200OKAnfrage erfolgreichInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerfalschkeineStatuscode, 200 Erfolgreich, 3 ungültiger app_key, 156 Konto nicht mit echtem Namen authentifiziert
» msgZeichenketteFalschKeineStatusmeldung
» DatenObjektfalschkeinekeine
»» Liste[Objekt]falschkeinekeine
»»» idintegerfalschkeinePaketnummer
»»» created_atZeichenfolgeFalschKeineGültigkeitsbeginn des Pakets
»»» expired_atstringFalschKeineDas Ablaufdatum des Pakets ist abgelaufen. Nach Ablauf kann der Datenverkehr nicht mehr genutzt werden.
»»» product_typeproductTypesfalsekeinePakettyp, 9 dynamische Wohn-Traffic-Pakete, 11 dynamische Wohn-IPs, 14 statische Rechenzentrums-IPs, 25 statische Wohn-IPs
»»» trade_nostringfalschkeineBestelltransaktionsnummer
»»» BestellungObjektFalschKeineKeine
»»»» erstellt_amstringFalschKeineBestellzeitpunkt
»»»» pay_atZeichenfolgeFalschKeineBestellzahlungszeit
»»»» TitelstringFalschKeineAuftragsbeschreibung
»» SeiteintegerFalschkeineAktuelle Pagierung
»» SeitengrößeintegerfalschkeineSeitengröße
»» total_countintegerFalschKeineGesamtzahl der Datensätze
»» GesamtseitenzahlGanzzahlFalschKeineGesamtzahl der Seiten

Enumerationswert

AttributWert
Produktart9
Produktart11
Produktart14
Produktart25

GET Benutzerpaket-Zusammenfassung

GET /api-gate-way/user-product/summary

Ruft statistische Zusammenfassungsinformationen der Benutzerpakete ab, einschließlich Gesamtmenge, gültiger Menge, bald ablaufender Menge, abgelaufener Menge usw.

Anfrageparameter

ParameternameTypErforderlichBeschreibung
app_keystring(password)JaAuthentifizierungsschlüssel
product_typeintegerNeinProdukttyp, unterstützt nur: 9 (Dynamisches Traffic-Paket), 12 (Langzeit-IDC-Traffic-Paket)

Antwort

{
	"code": 200,
	"msg": "Erfolg",
	"data": {
		"total": 1048576,
		"total_count": 5,
		"effective": 524288,
		"effective_count": 3,
		"effective_total": 786432,
		"effective_used": 262144,
		"temporary": 102400,
		"temporary_count": 1,
		"expired": 51200,
		"expired_count": 1,
		"used": 473088
	}
}

Antwortdatenstruktur

Statuscode 200

FeldTypBeschreibung
totalintegerGesamtmenge an Traffic/IP (Einheit: KB)
total_countintegerGesamtanzahl der Pakete
effectiveintegerVerbleibende gültige Menge (Einheit: KB)
effective_countintegerAnzahl gültiger Pakete
effective_totalintegerGesamte gültige Menge (Einheit: KB)
effective_usedintegerBereits verwendete gültige Menge (Einheit: KB)
temporaryintegerGesamtmenge bald ablaufend (läuft innerhalb von 7 Tagen ab, KB)
temporary_countintegerAnzahl bald ablaufender Pakete (innerhalb von 7 Tagen)
expiredintegerVerbleibende abgelaufene Menge (Einheit: KB)
expired_countintegerAnzahl abgelaufener Pakete
usedintegerInsgesamt verwendete Menge (Einheit: KB)

IP-Extraktion

GET IP extrahieren

GET /api-gate-way/ip/v3

Anfrageparameter

NamePositionTypErforderlichBeschreibung
App-KeyqueryString (Passwort)NeinZugriffsschlüssel
ccAbfrageZeichenfolgeNeinLand oder Region
BundeslandAbfrageZeichenketteNeinBundesland oder Kanton
StadtAbfrageZeichenketteNeinStadt
formatAbfrageZeichenketteNeinFormat abrufen
lbAbfragestringNeinTrennzeichen, nur im Textformat gültig
AnzahlAbfrageAnzahlNeinAnzahl extrahieren
LebenAbfrageAnzahlNeinAufbewahrungsdauer – Minuten
epAbfrageZeichenfolgeNeinProxy-Netzwerk

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			[
				"150.109.114.72:1140",
				"150.109.114.72:1141",
				"150.109.114.72:1142",
				"150.109.114.72:1143",
				"150.109.114.72:1144",
				"150.109.114.72:1145",
				"150.109.114.72:1146",
				"150.109.114.72:1147",
				"150.109.114.72:1148",
				"150.109.114.72:1149"
			]
		]
	}
}

Rückgabeergebnis

StatuscodesBedeutung der StatuscodesErläuterungDatenmodell
200OKAnfrage sendenInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerfalschkeineStatuscode, 200 Erfolgreich, 3 ungültiger app_key, 156 Konto nicht persönlich identifiziert
» msgZeichenketteFalschKeineStatusmeldung
» DatenObjektfalschkeinekeine
»» Liste[irgendwelche]falschkeinekeine

GET Städte-Liste

GET /api-gate-way/ip/dynamic-citys

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"city": null,
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

Ergebnis zurückgeben

StatuscodeStatuscode-BedeutungErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschkeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht identifiziert
» msgstringfalschkeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Objekt]FalschKeineListe
»»» name_zh_cnstringFalschkeineName des Landes oder der Region
»»» name_enstringfalschkeineName des Landes oder der Region
»»» continent_codeZeichenfolgeFalschKeineKontinentcode
»»» LändercodeZeichenfolgefalschkeineLändervorwahl
»»» Elemente[Objekt]falschkeineBundesland oder Kanton
»»»» StadtZeichenfolgefalschkeineStadtname
»»»» BundeslandZeichenfolgeFalschKeineCode für Bundesland oder Kanton
»»»» continent_codestringfalseKeineKontinentcode
»»»» country_codestringFalschkeineLänder- oder Regionscode

GET Stadtsuche

GET /api-gate-way/ip/dynamic-citys/search

Anfrageparameter

NamePositionTypErforderlichBeschreibung
country_codeAbfrageZeichenfolgeIstLänder- oder Regionscode
BundeslandAbfrageZeichenfolgeJaBundesstaat- oder Provinzcode

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

Ergebnis zurückgeben

StatuscodeStatuscode-BedeutungErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschkeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht mit echtem Namen authentifiziert
» msgstringfalschkeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Zeichenfolge]falschkeineListe

GET-Staatenliste

GET /api-gate-way/ip/dynamic-states

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": [
			{
				"name_zh_cn": "美国",
				"name_en": "United States",
				"continent_code": "NA",
				"country_code": "US",
				"items": [
					{
						"state": null,
						"continent_code": null,
						"country_code": null
					}
				]
			}
		]
	}
}

Rückgabeergebnis

StatuscodeBedeutung des StatuscodesErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht mit echtem Namen authentifiziert
» msgstringFalschkeineStatusmeldung
» DatenObjektfalschkeinekeine
»» Liste[Objekt]FalschKeineListe
»»» name_zh_cnZeichenfolgefalschkeineName des Landes oder der Region
»»» name_enstringFalschkeineName des Landes oder der Region
»»» continent_codestringfalschkeineKontinentcode
»»» LändercodeZeichenfolgeFalschKeineLänder- oder Regionscode
»»» Elemente[Objekt]falschkeineBundesland oder Staat
»»»» StaatZeichenkettefalschkeineCode für Bundesland oder Kanton
»»»» continent_codestringfalschkeineKontinentcode
»»»» country_codeZeichenfolgeFalschKeineLänder- oder Regionscode

GET Bundesland-/Provinzsuche

GET /api-gate-way/ip/dynamic-states/search

Anfrageparameter

NamePositionTypErforderlichBeschreibung
LändercodeAbfrageZeichenfolgeJaLänder- oder Regionscode

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "string",
	"data": {
		"list": ["string"]
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage sendenInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichEinschränkungChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» NachrichtZeichenfolgefalschkeineStatusmeldung
» dataObjektfalschkeinekeine
»» Liste[Zeichenkette]falschkeineListe

GET Ruft die Liste der gekauften statischen IPs ab

GET /api-gate-way/ip/get-static-ip

Anfrageparameter

NamePositionTypErforderlichBeschreibung
country_codeAbfrageZeichenfolgeNeinLänder- oder Regionscode
ProduktartAbfrageAnzahlNeinProduktart, 25: Statische Wohn-IP, 14: Rechenzentrums-IP
trade_noquerystringNeinIP nach Bestellnummer filtern
SeiteAbfrageAnzahlNeinSeitenzahl
GrößeAbfrageAnzahlNeinAnzahl pro Seite
statusAbfrageNummerNeinStatus, 1: Aktiv, 2: Inaktiv, 3: Läuft bald ab, 4: In Wartung

Enumerationswert

AttributWert
product_type14
product_type25
status1
status2
status3
status4

Beispiel für die Rückgabe

200 Antwort

{}

Ergebnis zurückgeben

StatuscodeStatuscode BedeutungBeschreibungDatenmodell
200OKkeineInline

Datenstruktur zurückgeben

GET Ruft die Anzahl der verfügbaren statischen IPs in der Region ab

GET /api-gate-way/static-ip-region

Anfrageparameter

NamePositionTypErforderlichBeschreibung
ispAbfrageZeichenfolgeNeinIP-Typ

IP-Typ Beschreibung

IP-TypBeschreibung
1Statisches Heim-IP
0Statisches Rechenzentrums-IP

Beispiel für die Rückgabe

200 Antwort

{
	"code": 200,
	"msg": "请求成功",
	"data": {
		"list": [
			{
				"code": "US",
				"number": 55
			}
		]
	}
}

Rückgabeergebnis

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKkeineInline

Zurückgegebene Datenstruktur

Statuscode 200

NameTypErforderlichEinschränkungChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich
» NachrichtZeichenfolgefalschkeineStatusmeldung
» dataObjektfalschkeinekeine
»» Liste[Objekt]falschkeinekeine
»»» codeZeichenfolgeFalschKeineLänder- oder Regionscode
»»» NummerGanzzahlFalschKeineMenge

Auftragsverwaltung

GET Bestellliste

GET /api-gate-way/order/list

Anfrageparameter

NamePositionTypErforderlichBeschreibung
SeitenzahlAbfrageGanzzahlNeinKeine
Seiten GrößeAbfrageintegerNeinKeine
trade_noAbfrageZeichenfolgeNeinBestellnummer
statusAbfrageGanzzahlNeinBestellstatus
ProduktartAbfrageGanzzahlNeinProduktart

Detaillierte Beschreibung

status: Bestellstatus

StatusBeschreibung
0Zahlung ausstehend
1Bezahlt
2Die Zahlungsfrist ist abgelaufen. Bestellung wurde storniert.
3Erstattet

product_type: Produkttyp

ProdukttypBeschreibung
3Guthaben aufladen
9Dynamischer Datentarif
11Dynamischer globaler Zeittarif V2
12Langfristige IDC-Traffic-Pakete
13Traffic-Pakete mit statischer Wohn-IP-Adresse
14Statische IP-Pakete für Rechenzentren
15Langfristige ISP-Traffic-Pakete
16Statischer Traffic-Tarif
17Dynamischer IP-Anzahl-Tarif
18web-scraper
19Statische IP-Verlängerung
20Statisches IP-Änderungskontingent
21Statischer Traffic-Plan v2
24Zusätzliches statisches Traffic-Paket
25Statisches Wohn-IP-Paket
26Ergänzung der Bestellung - Bei einigen Zahlungskanälen müssen Benutzer den Betrag manuell eingeben, z. B. bei virtuellen Währungen. Wenn ein Fehlbetrag auftritt, muss sich der Benutzer an den Kundendienst wenden, um die Nachzahlung über dieses Produkt vorzunehmen.
27Serp
28Video

Enumerationswert

AttributWert
status0
status1
status2
status3
Produkttyp3
Produkttyp9
Produktart11
Produktart12
Produktart14
Produktart16
Produktart17
Produktart18
Produktart19
Produktart21
Produktart24
Produktart25
Produkttyp26
Produktart27
Produktart28

Beispiel für die Rückgabe

200 Antwort

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"id": 0,
				"trade_no": "string",
				"product_id": 0,
				"product_name": "string",
				"total_fee": 0.1,
				"pay_fee": 0.1,
				"status": 0,
				"created_at": "2019-08-24T14:15:22Z"
			}
		],
		"pagination": {
			"total": 0,
			"page_no": 0,
			"page_size": 0,
			"total_pages": 0
		}
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKErfolgInline

Datenstruktur zurückgeben

POST Bestellung erstellen

POST /api-gate-way/order/create

Da es viele verschiedene Paketarten gibt und jede Paketart unterschiedliche Konfigurationen aufweist, füllen Sie die Parameter bitte entsprechend der tatsächlichen Situation aus. Eine unsachgemäße Ausfüllung der Parameter kann dazu führen, dass die Bestellung nicht erstellt werden kann.

Beispiele:

Statische IP verlängern

{
    "pid": x, // 联系客服获取
    "upids": "1,2,3,4,5,6", // 从 /api-gate-way/ip/get-static-ip 获取对应的ID
    "pm_id": 1 // 从 /api-gate-way/payment/list 获取
    "coupon_sn: "xxx", // 可选 优惠券
  }

Body-Anfrageparameter

{
	"pid": 0,
	"upids": "string",
	"amount": 0,
	"pm_id": 0,
	"region_list": "string",
	"coupon_sn": "string",
	"use_invitation_registration_discount": true,
	"renew_duration": 0,
	"product_sku_bandwidth_id": 0,
	"product_sku_concurrency_id": 0,
	"recharge_amount": 0
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektJakeine
» pidbodyintegerJaPaket-ID
» upidsbodyZeichenfolgeNeinListe der IDs der Verlängerungsangebote
» amountbodyAnzahlNeinAnzahl der neu erworbenen Pakete
» pm_idbodyintegerJaZahlungsart-ID
» region_listbodyZeichenfolgeNeinBeim Kauf einer statischen IP-Adresse die Region + Anzahl angeben
» coupon_snbodyZeichenfolgeNeinGutscheinnummer
» use_invitation_registration_discountbodybooleanNeinSoll ein Rabatt für die Registrierung per Einladung verwendet werden?
» renew_durationbodyintegerNeinVerlängerungsdauer - Statische IP optional
» product_sku_bandwidth_idbodyintegerNeinPaket 11: Bandbreitenpaket-ID
» product_sku_concurrency_idbodyintegerNeinPaket 11: ID des Parallelitätspakets
» recharge_amountbodyintegerNeinPaket 3: Aufladebetrag

Beispiel für die Rückgabe

200 Antwort

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"id": 0,
		"trade_no": "string",
		"product_id": 0,
		"product_name": "string",
		"total_fee": 0.1,
		"pay_fee": 0.1,
		"status": 0,
		"created_at": "2019-08-24T14:15:22Z"
	}
}

Ergebnis zurückgeben

StatuscodeStatuscode-BedeutungBeschreibungDatenmodell
200OKErfolgreich erstelltInline

Datenstruktur zurückgeben

POST Bestellung stornieren

POST /api-gate-way/order/close

Body Anforderungsparameter

{
	"trade_no": "string"
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektJakeine
» trade_nobodyZeichenfolgeJakeine

Rückgabeergebnis

StatuscodesBedeutung der StatuscodesBeschreibungDatenmodell
200OKOperation erfolgreichKeine

Benutzerverwaltung

GET Benutzerinformationen abrufen - Noch nicht geöffnet

GET /api-gate-way/user/info

Beispiel für die Rückgabe

200 Antwort

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"id": 0,
		"email": "[email protected]",
		"phone": "string",
		"balance": 0.1,
		"status": 0,
		"is_real_name": true,
		"created_at": "2019-08-24T14:15:22Z"
	}
}

Rückgabeergebnis

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKErfolgreichInline

Zurückgegebene Datenstruktur

Zahlungsverwaltung

GET Ruft die Liste der Zahlungsmethoden ab

GET /api-gate-way/payment/groups

Anforderungsparameter

NamePositionTypErforderlichBeschreibung
trade_noqueryZeichenfolgeNeinBestellnummer - Einige Bestellungen müssen bei der Abfrage einer bestimmten Zahlungsmethode übergeben werden

Beispiel zurückgeben

200 Antwort

{
	"code": 0,
	"message": "操作成功",
	"data": {
		"list": [
			{
				"name": "支付方式分组",
				"logos": ["https://example.com/logo1.png", "https://example.com/logo2.png"],
				"items": [
					{
						"id": 1,
						"title": "title1",
						"logo": "https://example.com/logo1.png",
						"group": "online",
						"disabled": false,
						"min": 10,
						"max": 5000
					}
				]
			}
		]
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung der StatuscodesBeschreibungDatenmodell
200OKErfolgreich abgerufenInline

Datenstruktur zurückgeben

NameTypErforderlichEinschränkungenChinesischer NameBeschreibung
» codeintegerfalschkeineStatuscode, 200 Erfolgreich, 3 App_Key ungültig, 156 Konto nicht echtzeitverifiziert
» msgZeichenfolgefalschkeineStatusmeldung
» dataObjektfalschkeinekeine
»» nameZeichenfolgefalschkeineGruppenname
»» logosstring[]falschkeineListe der Gruppensymbole
»» Elementeobject[]falschkeineListe der Elemente innerhalb der Gruppe
»»» idintegerfalschkeineZahlungsart-ID
»»» TitelZeichenfolgefalschkeineName der Zahlungsart
»»» logoZeichenfolgefalschkeineZahlungsmethoden-Logo
»»» groupZeichenfolgefalschkeineKennzeichen der Zahlungsmethodengruppe
»»» deaktiviertbooleschfalschkeineDeaktivieren (Standard false)
»»» minZahlfalschkeineMindestbetrag
»»» maxAnzahlfalschkeineMaximalbetrag

Marketing

GET Aufladebonus-Verhältnis

GET /api-gate-way/activity/balance-recharge-gift-ratio

Aufladebonus-Verhältnis

Beispiel für die Rückgabe

200 Antwort

{
	"code": 0,
	"msg": "操作成功",
	"data": {
		"list": [
			{
				"amount": 100,
				"ratio": 1.2
			}
		]
	}
}

Rückgabeergebnis

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKOKInline

Datenstruktur zurückgeben

NameTypErforderlichBeschränkungenChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht identifiziert
» msgstringFalschKeineStatusmeldung
» dataObjektFalschKeineKeine
» Liste[Objekt]FalschKeineKeine
»» BetragintegerFalschKeineAufladebetrag
»» VerhältnisAnzahlFalschKeineAufladeverhältnis

Datenstrukturbeschreibung (Schemas)

productTypes (Pakettypen)

FeldTypBeschreibung
product_typeintegerPakettyp

Erläuterung der optionalen Werte:

WertBedeutung
9Dynamische Residential-Traffic-Pakete
11Dynamische Residential-IP
14Statische Rechenzentrums-IP
25Statische Residential-IP

API-Schlüssel (Authentifizierungsschlüssel)

Wird zur Schnittstellenauthentifizierung verwendet und muss über den Query-Parameter übergeben werden.

ParameternamePositionTypErforderlichBeschreibung
app_keyquerystringJaAuthentifizierungsschlüssel

Allgemeine Antwortfelder

Antwortcode

FeldTypBeispielBeschreibung
codeinteger200Statuscode (200 bedeutet Erfolg, 3 bedeutet ungültiger app_key)

responseMsg

FeldTypBeispielBeschreibung
NachrichtstringErfolgAntwortnachricht

Erfolgreiche Antwort (SuccessResponse)

{
	"code": 0,
	"message": "操作成功",
	"data": {}
}

Fehlerhafte Antwort (ErrorResponse)

{
	"code": 400,
	"message": "参数错误",
	"errors": {}
}

Benutzer

{
	"id": 0,
	"email": "[email protected]",
	"phone": "string",
	"balance": 0.1,
	"status": 0,
	"is_real_name": true,
	"created_at": "2019-08-24T14:15:22Z"
}
NameTypErforderlichBeschränkungChinesischer NameBeschreibung
idGanzzahlFalschKeineKeine
E-MailZeichenfolge (E-Mail)FalschKeineKeine
TelefonstringFalschKeineKeine
GuthabenZahl (Gleitkommazahl)FalschKeineKeine
statusintegerFalschKeineKeine
is_real_namebooleanFalschKeineKeine
erstellt_amString (Datum-Uhrzeit)FalschKeineKeine

Bestellung

{
	"id": 0,
	"trade_no": "string",
	"product_id": 0,
	"product_name": "string",
	"total_fee": 0.1,
	"pay_fee": 0.1,
	"status": 0,
	"created_at": "2019-08-24T14:15:22Z"
}
NameTypErforderlichEinschränkungChinesischer NameBeschreibung
idintegerFalschKeineKeine
HandelsnummerstringFalschKeineKeine
Produkt-IDintegerFalschKeineKeine
ProduktnamestringFalschKeineKeine
GesamtgebührZahl (Gleitkommazahl)FalschKeineKeine
Gebühr_zahlenZahl (Gleitkommazahl)FalschKeineKeine
statusintegerFalschKeineKeine
created_atString (Datum/Uhrzeit)FalschKeineKeine

Produkt

{
	"id": 0,
	"name": "string",
	"type": 0,
	"price": 0.1,
	"description": "string"
}
NameTypErforderlichEinschränkungChinesischer NameBeschreibung
idintegerFalschKeineKeine
namestringFalschKeineKeine
TypintegerFalschKeineKeine
PreisZahl (Gleitkommazahl)FalschKeineKeine
BeschreibungstringFalschKeineKeine

WhiteIp

{
	"id": 0,
	"ip": "string",
	"remark": "string",
	"created_at": "2019-08-24T14:15:22Z"
}
NameTypErforderlichEinschränkungChinesischer NameBeschreibung
idintegerFalschKeineKeine
ipstringFalschKeineKeine
BemerkungstringFalschKeineKeine
Erstellt_amString(Datum-Uhrzeit)FalschKeineKeine

WhitelistAccount

{
	"id": 0,
	"username": "string",
	"limit": 0,
	"used": 0,
	"status": 0
}
NameTypErforderlichEinschränkungChinesischer NameBeschreibung
idintegerFalschKeineKeine
BenutzernamestringFalschKeineKeine
limitintegerFalschKeineKeine
VerwendetintegerFalschKeineKeine
statusGanzzahlFalschKeineKeine

Gutschein

{
	"id": 0,
	"name": "string",
	"code": "string",
	"discount": 0.1,
	"expire_time": "2019-08-24T14:15:22Z"
}
NameTypErforderlichEinschränkungChinesischer NameBeschreibung
idintegerFalschKeineKeine
namestringFalschKeineKeine
codestringFalschKeineKeine
RabattAnzahl (Gleitkommazahl)FalschKeineKeine
AblaufzeitZeichenfolge (Datum-Uhrzeit)FalschKeineKeine

Artikel

{
	"id": 0,
	"title": "string",
	"content": "string",
	"created_at": "2019-08-24T14:15:22Z"
}
NameTypErforderlichEinschränkungChinesischer NameBeschreibung
idintegerFalschKeineKeine
TitelstringFalschKeineKeine
InhaltstringFalschKeineKeine
Erstellt amZeichenkette (Datum-Uhrzeit)FalschKeineKeine

Seitennummerierung

{
	"total": 0,
	"page_no": 0,
	"page_size": 0,
	"total_pages": 0
}
NameTypErforderlichEinschränkungChinesischer NameBeschreibung
gesamtintegerFalschKeineKeine
seite_nrintegerFalschKeineKeine
seiten_größeintegerFalschKeineKeine
total_pagesintegerFalschKeineKeine