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

ProxyCC OpenAPI

Den app_key-Authentifizierungsschlüssel finden Sie nach dem Einloggen auf der Homepage Ihres persönlichen Bereichs.

Bitte bewahren Sie den Schlüssel sicher auf, da er über Ihre Administratorkontoberechtigungen verfügt.

Basis-URLs:

https://api.proxy.cc

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)

Übermittlung des Tokens über den 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 /open/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
			}
		]
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage erfolgreichInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeAntwortcodeFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Objekt]FalschKeineKeine
»»» idGanzzahlFalschKeineKontonummer
»»» BenutzernamestringFalschKeineName des Agentenkontos
»»» PasswortstringFalschKeinePasswort des Agentenkontos
»»» erstellt_amstringFalschKeineHinzufügezeit
»»» BemerkungstringFalschKeineAnmerkungen
»»» product_typeproductTypesFalschKeinePakettyp: 9 Dynamisches Residential-Traffic-Paket, 11 Dynamische Residential-IP, 14 Statische Rechenzentrums-IP, 25 Statische Residential-IP
»»» usage_flowGanzzahlFalschKeineVerbrauchter Traffic, Einheit: KB
»»» limit_flowGanzzahlFalschKeineBenutzerdefinierte Trafficobergrenze: Einheit GB, maximal 102400, 0 bedeutet unbegrenzt
»»» statusGanzzahlFalschKeineAktivierungsstatus: 1 aktiviert, 0 deaktiviert

Enumerationswert

AttributWert
product_type9
product_type11
product_type14
product_type25

POST Agentenkonto hinzufügen

POST /open/whitelist-account/add

Body-Anfrageparameter

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

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» 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. Konto und Passwort werden durch einen Doppelpunkt getrennt. Die Batch-Hinzufügung wird unterstützt, wobei Proxy-Konten durch ein englisches Komma (,) getrennt werden.
» BemerkungbodystringNeinBeschreibung des Proxy-Kontos
» ProduktartbodyproductTypesNeinPakettyp: 9 Dynamisches Wohn-Traffic-Paket, 11 Dynamische Wohn-IP, 14 Statische Rechenzentrums-IP, 25 Statische Wohn-IP

Enumerationswert

AttributWert
» Produktart9
» Produktart11
» Produktart14
» Produktart25

Beispiel für die Rückgabe

200 Antwort

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

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage erfolgreichInline

Datenstruktur zurückgeben

Statuscode 200

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

POST Proxy-Konto löschen

POST /open/whitelist-account/delete

Bitte beachten Sie, dass die Löschung nicht rückgängig gemacht werden kann und der verbrauchte Datenverkehr 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_keybodystringNeinAutorisierungsschlüssel
» accountsbodystringNeinProxy-Konto, unterstützt nur Zahlen und Buchstaben. Unterstützt Batch-Operationen, Proxy-Konten werden durch ein englisches Komma (,) getrennt.

Beispiel für die Rückgabe

200 Antwort

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

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

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

POST Proxy-Konto deaktivieren

POST /open/whitelist-account/disable

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

Body-Anfrageparameter

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

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlü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
}

Rückgabeergebnis

StatuscodeBedeutung des StatuscodesErläuterungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

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

POST-Aktivierung des Proxy-Kontos

POST /open/whitelist-account/enable

Body-Anfrageparameter

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

Anfrageparameter

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

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

NameTypErforderlichEinschränkungChinesischer NameBeschreibung
» codeintegerFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht identifiziert
» msgstringFalschkeineStatusmeldung
» Datennullfalschkeinekeine

POST-Anfrage zum Ändern des Passworts eines Proxy-Kontos

POST /open/whitelist-account/change-password

Bitte beachten Sie, dass es nach der Änderung eine Wartezeit von 5 Minuten gibt, in der das alte Passwort möglicherweise noch normal verwendet werden kann.

Body-Anfrageparameter

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

Anfrageparameter

NamePositionTypErforderlichErläuterung
bodybodyObjektNeinkeine
» app_keybodyZeichenfolgeNeinAutorisierungsschlüssel
» KontobodystringNeinProxy-Konto, unterstützt nur Zahlen und Buchstaben.
» PasswortbodystringNeinDas neue Passwort für das Agentenkonto unterstützt nur Zahlen und Buchstaben.

Beispiel für die Rückgabe

200 Antwort

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

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

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

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

POST /open/whitelist-account/change-remark

Body-Anfrageparameter

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

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlüssel
» KontobodystringNeinProxy-Konto, unterstützt nur Zahlen und Buchstaben.
» BemerkungbodystringNeinNeue Notiz für das Agentenkonto, maximal 32 Zeichen in Chinesisch oder 64 Zeichen in Englisch.

Beispiel für die Rückgabe

200 Antwort

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

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

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

POST Datenvolumenlimit des Proxy-Kontos ändern

POST /open/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 diese Beschränkung überschreiten.

Body-Anfrageparameter

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

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektNeinKeine
» app_keybodystringNeinAutorisierungsschlüssel
» KontobodystringNeinProxy-Konto, unterstützt nur Zahlen und Buchstaben.
» limitbodyGanzzahlNeinTraffic-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 StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

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

Traffic-Log-Abfrage

GET Verwendung des Datenverkehrs nach Tagen zusammenfassen

GET /open/user-usage-flow/total

Anfrageparameter

NamePositionTypErforderlichBeschreibung
app_keyAbfragestring(password)JaAuthentifizierungsschlüssel
start_timeAbfrageString(J-m-d H:i:s)NeinStartzeit, kann bis auf die Sekunde genau sein. Bitte beachten Sie, dass die Protokollierung eine Verzögerung von bis zu 5 Minuten aufweist. Standardmäßig innerhalb von 7 Tagen.
end_timeAbfragestring(Y-m-d H:i:s)NeinEndzeitpunkt, kann bis auf die Sekunde genau sein. 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.
usernameAbfragestringNeinName des Unterkontos, standardmäßig werden alle Konten abgefragt, ein Unterkonto kann angegeben werden. Bitte beachten Sie, dass diese Abfrage alle Nutzungsdatensätze des gleichnamigen Agenturkontos zurückgibt, wenn Sie Unterkonten mit demselben Namen hinzugefügt haben.
product_typeAbfrageAnzahlNeinPakettyp

Beispiel für die Rückgabe

200 Antwort

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

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» dataObjektFalschKeineKeine
»» list[Objekt]FalschKeineKeine
»»» TagstringFalschKeineDatum
»»» FlussGanzzahlFalschKeineVerbrauchter Traffic, Einheit KB

Paketabfrage

GET Liste der gekauften Pakete

GET /open/user-product/list

Anfrageparameter

NamePositionTypErforderlichBeschreibung
app_keyAbfragestring(password)JaAuthentifizierungsschlüssel
trade_noAbfragestringNeinBestellnummer, bitte geben Sie die vollständige Bestellnummer ein. Fuzzy-Suche wird nicht unterstützt.
SeiteAbfrageAnzahlNeinSeitennummerierung, Standard: 1
GrößeAbfrageAnzahlNeinAnzahl der Einträge pro Seite, Standard: 20
product_typeAbfrageAnzahlNeinPakettyp

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
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» dataObjektFalschKeineKeine
»» Liste[Objekt]FalschKeineKeine
»»» idGanzzahlFalschKeinePaketnummer
»»» erstellt_amstringFalschKeinePaketaktivierungszeit
»»» expired_atstringFalschKeinePaketablaufzeit, nach Ablauf kann der Datenverkehr nicht mehr genutzt werden.
»»» product_typeproductTypesFalschKeinePakettyp, 9 dynamische Wohn-Traffic-Pakete, 11 dynamische Wohn-IPs, 14 statische Rechenzentrums-IPs, 25 statische Wohn-IPs
»»» trade_nostringFalschKeineBestelltransaktionsnummer
»»» BestellungObjektFalschKeineKeine
»»»» erstellt_amstringFalschKeineBestellerstellungszeit
»»»» Bezahlen beistringFalschKeineZeitpunkt der Auftragszahlung
»»»» TitelstringFalschKeineAuftragsbeschreibung
»» SeiteGanzzahlFalschKeineAktuelle Seitenzahl
»» SeitengrößeGanzzahlFalschKeineSeitengröße
»» GesamtanzahlGanzzahlFalschKeineGesamtzahl der Datensätze
»» total_pageGanzzahlFalschKeineGesamtzahl der Seiten

Enumerationswert

AttributWert
product_type9
product_type11
product_type14
product_type25

IP-Extraktion

GET-IP-Extraktion

GET /open/ip/v3

Anfrageparameter

NamePositionTypErforderlichBeschreibung
app_keyAbfragestring(password)NeinZugriffsschlüssel
ccAbfragestringNeinLand oder Region
BundeslandAbfragestringNeinBundesland oder Kanton
StadtAbfragestringNeinStadt
formatAbfragestringNeinFormat abrufen
lbAbfragestringNeinTrennzeichen, nur für Textformat gültig
ZahlAbfrageAnzahlNeinAnzahl der Extraktionen
LebenAbfrageAnzahlNeinBeibehalten-Zyklus - Minuten
epAbfragestringNeinProxy-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"
			]
		]
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[beliebig]FalschKeineKeine

GET Stadtliste

GET /open/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

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Objekt]FalschKeineListe
»»» name_zh_cnstringFalschKeineName des Landes oder der Region
»»» name_enstringFalschKeineName des Landes oder der Region
»»» continent_codestringFalschKeineKontinentcode
»»» LändercodestringFalschKeineLänder- oder Regionscode
»»» Artikel[Objekt]FalschKeineBundesland oder Kanton
»»»» StadtstringFalschKeineName der Stadt
»»»» BundeslandstringFalschKeineCode für Provinz- oder Bundesstaatsnamen
»»»» continent_codestringFalschKeineKontinentcode
»»»» country_codestringFalschKeineLänder- oder Regionscode

GET Stadtsuche

GET /open/ip/dynamic-citys/search

Anfrageparameter

NamePositionTypErforderlichBeschreibung
country_codeAbfragestringJaLänder- oder Regionscode
BundeslandAbfragestringJaBundesstaat- oder Provinzcode

Beispiel für die Rückgabe

200 Antwort

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

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Zeichenkette]FalschKeineListe

GET Zustandsliste

GET /open/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
					}
				]
			}
		]
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKAnfrage nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Objekt]FalschKeineListe
»»» name_zh_cnstringFalschKeineName des Landes oder der Region
»»» name_enstringFalschKeineName des Landes oder der Region
»»» continent_codestringFalschKeineKontinentcode
»»» country_codestringFalschKeineLänder- oder Regionscode
»»» items[Objekt]FalschKeineBundesland oder Kanton
»»»» statestringFalschKeineCode für Provinz- oder Bundesstaatsnamen
»»»» continent_codestringFalschKeineKontinentcode
»»»» country_codestringFalschKeineLänder- oder Regionscode

GET Bundesland-/Provinzsuche

GET /open/ip/dynamic-states/search

Anfrageparameter

NamePositionTypErforderlichBeschreibung
country_codeAbfragestringJaLä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 nachInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Zeichenkette]FalschKeineListe

GET Ruft die Liste der gekauften statischen IPs ab

GET /open/ip/get-static-ip

Anfrageparameter

NamePositionTypErforderlichBeschreibung
country_codeAbfragestringNeinLänder- oder Regionscode
product_typeAbfrageAnzahlNeinProdukttyp, 25: Statische Wohn-IP, 14: Rechenzentrums-IP
trade_noAbfragestringNeinIPs nach Bestellnummer filtern
SeiteAbfrageAnzahlNeinSeitenzahl
GrößeAbfrageAnzahlNeinAnzahl pro Seite
statusAbfrageAnzahlNeinStatus, 1: Gültig, 2: Ungültig, 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

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKKeineInline

Datenstruktur zurückgeben


GET Ruft die Anzahl der statischen IP-Adressen in den Verkaufsregionen ab

GET /open/static-ip-region

Anfrageparameter

NamePositionTypErforderlichBeschreibung
ispAbfragestringNeinIP-Typ

Erläuterung zum IP-Typ

IP-TypBeschreibung
1Statisches privates Wohn-IP
0Statisches Rechenzentrums-IP

Beispiel für die Rückgabe

200 Antwort

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

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKKeineInline

Datenstruktur zurückgeben

Statuscode 200

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» Liste[Objekt]FalschKeineKeine
»»» codestringFalschKeineLänder- oder Regionscode
»»» NummerGanzzahlFalschKeineAnzahl

Bestellverwaltung

GET Bestellliste

GET /open/order/list

Anfrageparameter

NamePositionTypErforderlichBeschreibung
Seite_nr.AbfrageGanzzahlNeinKeine
Seiten GrößeAbfrageGanzzahlNeinKeine
trade_noAbfragestringNeinBestellnummer
statusAbfrageGanzzahlNeinBestellstatus
product_typeAbfrageGanzzahlNeinProduktart

Detaillierte Beschreibung

status: Bestellstatus

StatusBeschreibung
0Ausstehende Zahlung
1Bezahlt
2超时未支付已取消 (Dieser Satz bleibt unverändert, da er Chinesisch ist.)
3Erstattet

product_type: Produkttyp

ProdukttypBeschreibung
3Guthaben aufladen
9Dynamische Datenpakete
11Dynamische globale Zeittarife V2
12Langfristige IDC-Datenpakete
13Statische Wohn-IP-Datenpakete
14Statische IP-Pakete für Rechenzentren
15Langfristige ISP-Traffic-Pakete
16Statische Traffic-Pakete
17Dynamische IP-Anzahl-Pakete
18web-scraper
19Statische IP-Verlängerung
20Kontingent für statische IP-Adressänderungen
21Statische Traffic-Pakete v2
24Zusatzpakete für statischen Traffic
25Statische IP-Pakete für Wohngebäude
26Ergänzung der Bestellung - Bei einigen Zahlungskanälen müssen Benutzer den Betrag manuell eingeben, z. B. bei virtuellen Währungen. Wenn eine Unterdeckung auftritt, muss sich der Kundendienst mit diesem Produkt in Verbindung setzen, um die Nachzahlung vorzunehmen
27Serp
28Video

Enumerationswert

AttributWert
status0
status1
status2
status3
product_type3
product_type9
product_type11
product_type12
product_type14
product_type16
product_type17
product_type18
product_type19
product_type21
product_type24
product_type25
product_type26
product_type27
product_type28

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 /open/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", // 从 /end-point/ip/get-static-ip 获取对应的ID
    "pm_id": 1 // 从 /end-point/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
» pidbodyGanzzahlJaPaket-ID
» upidsbodystringNeinListe der IDs der Verlängerungspakete
» BetragbodyAnzahlNeinAnzahl der neu erworbenen Pakete
» pm_idbodyGanzzahlJaZahlungsarten-ID
» region_listbodystringNeinBeim Kauf einer statischen IP-Adresse die Region und Anzahl angeben
» coupon_snbodystringNeinGutscheinnummer
» use_invitation_registration_discountbodybooleanNeinOb der Einladungsregistrierungsrabatt verwendet wird
» renew_durationbodyGanzzahlNeinVerlängerungsdauer – Statische IP optional
» product_sku_bandwidth_idbodyGanzzahlNeinPaket 11: Bandbreiten-Paket-ID
» product_sku_concurrency_idbodyGanzzahlNeinPaket 11: Paket-ID für gleichzeitige Verbindungen
» recharge_amountbodyGanzzahlNeinPaket 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

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKErfolgreich erstelltInline

Datenstruktur zurückgeben


POST Bestellung stornieren

POST /open/order/close

Body-Anfrageparameter

{
	"trade_no": "string"
}

Anfrageparameter

NamePositionTypErforderlichBeschreibung
bodybodyObjektJaKeine
» trade_nobodystringJaKeine

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKOperation erfolgreichKeine

Benutzerverwaltung

GET Ruft Benutzerinformationen ab - Derzeit nicht verfügbar

GET /open/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"
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKErfolgInline

Datenstruktur zurückgeben


Zahlungsverwaltung

GET Ruft die Liste der Zahlungsmethoden ab

GET /open/payment/groups

Anfrageparameter

NamePositionTypErforderlichBeschreibung
trade_noAbfragestringNeinBestellnummer - Kann für bestimmte Bestellungen übergeben werden, wenn eine bestimmte Zahlungsmethode erforderlich ist

Beispiel für die Rückgabe

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 des StatuscodesBeschreibungDatenmodell
200OKErfolgreich abgerufenInline

Datenstruktur zurückgeben

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
»» namestringFalschKeineGruppenname
»» logosstring[]FalschKeineListe der Gruppensymbole
»» Elementeobject[]FalschKeineListe der Elemente innerhalb der Gruppe
»»» idGanzzahlFalschKeineZahlungsart-ID
»»» titlestringFalschKeineName der Zahlungsmethode
»»» logostringFalschKeineLogo der Zahlungsmethode
»»» groupstringFalschKeineZahlungsmethoden-Gruppenkennung
»»» disabledbooleanFalschKeineDeaktivieren (Standard false)
»»» minAnzahlFalschKeineMindestbetrag
»»» maxAnzahlFalschKeineMaximalbetrag

Marketing

GET Aufladebonus-Verhältnis

GET /open/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
			}
		]
	}
}

Ergebnis zurückgeben

StatuscodeBedeutung des StatuscodesBeschreibungDatenmodell
200OKOKInline

Datenstruktur zurückgeben

NameTypErforderlichBeschränkungChinesischer NameBeschreibung
» codeGanzzahlFalschKeineStatuscode, 200 Erfolgreich, 3 app_key ungültig, 156 Konto nicht echtzeit-authentifiziert
» msgstringFalschKeineStatusmeldung
» DatenObjektFalschKeineKeine
» Liste[Objekt]FalschKeineKeine
»» BetragGanzzahlFalschKeineAufladebetrag
»» VerhältnisAnzahlFalschKeineAufladeverhältnis

Datentruktur-Beschreibungen (Schemas)

productTypes (Pakettypen)

FeldTypBeschreibung
product_typeGanzzahlPakettyp

Optionale Werte erklärt:

WertBedeutung
9Dynamischer Wohnungs-Traffic-Tarif
11Dynamische Wohn-IP
14Statische Rechenzentrums-IP
25Statische Wohn-IP

API-Schlüssel (Authentifizierungsschlüssel)

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

ParameternamePositionTypErforderlichBeschreibung
app_keyAbfragestringJaAuthentifizierungsschlüssel

Allgemeine Antwortfelder

responseCode

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

Antwortnachricht

FeldTypBeispielBeschreibung
NachrichtstringErfolgAntwortinformationen

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-MailString(E-Mail)FalschKeineKeine
TelefonstringFalschKeineKeine
GuthabenZahl (Gleitkommazahl)FalschKeineKeine
statusGanzzahlFalschKeineKeine
ist_echter_NameBooleschFalschKeineKeine
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"
}
NameTypErforderlichBeschränkungChinesischer NameBeschreibung
idGanzzahlFalschKeineKeine
trade_nostringFalschKeineKeine
Produkt_IDGanzzahlFalschKeineKeine
ProduktnamestringFalschKeineKeine
GesamtgebührZahl (Gleitkommazahl)FalschKeineKeine
ZahlungsgebührZahl (Gleitkommazahl)FalschKeineKeine
statusGanzzahlFalschKeineKeine
Erstellt amString (Datum-Uhrzeit)FalschKeineKeine

Produkt

{
	"id": 0,
	"name": "string",
	"type": 0,
	"price": 0.1,
	"description": "string"
}
NameTypErforderlichBeschränkungChinesischer NameBeschreibung
idGanzzahlFalschKeineKeine
namestringFalschKeineKeine
TypGanzzahlFalschKeineKeine
PreisZahl (Gleitkommazahl)FalschKeineKeine
BeschreibungstringFalschKeineKeine

WhiteIp

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

WhitelistAccount

{
	"id": 0,
	"username": "string",
	"limit": 0,
	"used": 0,
	"status": 0
}
NameTypErforderlichBeschränkungChinesischer NameBeschreibung
idGanzzahlFalschKeineKeine
BenutzernamestringFalschKeineKeine
limitGanzzahlFalschKeineKeine
verwendetGanzzahlFalschKeineKeine
statusGanzzahlFalschKeineKeine

Gutschein

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

Artikel

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

Paginierung

{
	"total": 0,
	"page_no": 0,
	"page_size": 0,
	"total_pages": 0
}
NameTypErforderlichBeschränkungChinesischer NameBeschreibung
gesamtGanzzahlFalschKeineKeine
Seite_nr.GanzzahlFalschKeineKeine
Seiten GrößeGanzzahlFalschKeineKeine
Gesamtzahl_SeitenGanzzahlFalschKeineKeine