v2

Die Nummern abrufen, deren Einkommen über einem Betrag liegt

GEThttps://{ourserver.com}/api/resellers/takeOffNumbers

Optionale Anfrage. Sie gibt Ihre Nummern zurück, deren Einkommen größer als sum ist, damit Sie schnell sehen, welche Nummern genug verdient haben und durch neue ersetzt werden können. Dieselben Daten finden Sie auf Ihrer persönlichen Seite.

Alle Ihre Nummern werden geprüft, einschließlich über Ausrüstung angeschlossener. Diese Anfrage bestätigt nicht, dass Ihr Server läuft.

Parameter

query2
NameTypBeschreibung
suminteger

Einkommensschwelle in RUB, eine ganze Zahl (ein Nachkommaanteil wird abgeschnitten). Zurückgegeben werden Nummern mit einem Einkommen größer als dieser Wert: Bei sum = 37 wird eine Nummer mit 37.00 RUB nicht zurückgegeben, eine mit 37.50 RUB schon.

Übergeben Sie einen negativen Wert (zum Beispiel -1), um alle Ihre Nummern zu erhalten.

Standard:50
teststring

Testmodus. Er kann auch im Anfragetext übergeben werden.

  • test1 — die Anfrage wird wie gewohnt ausgeführt und beantwortet, aber ihre Datenbankänderungen werden zurückgerollt. Wirkungen außerhalb der Datenbank treten trotzdem ein.
  • test2 — die Anfrage wird nicht ausgeführt: Die Antwort ist ein Debug-Dump (HTML, HTTP 200) der Anfrage-Header und des Anfragetexts, so wie unser Server sie empfangen hat.

Eine Anfrage mit einem beliebigen nicht leeren test-Wert bestätigt nicht, dass Ihr Server läuft.

Enumeration:test1test2
header1
NameTypBeschreibung
Authorization*string

Siehe Details hier

Antworten

200Nummern, deren Einkommen größer als sum ist
Content-Typeapplication/json
Schema
schemaobject
responsestringErforderlich
Enumeration:1Beispiel:1
listobject[]Erforderlich

Beispiele

twoNumbersZeilen: 17

Zwei Nummern über der Schwelle

{
  "response": "1",
  "list": [
    {
      "id": "40516575",
      "number": "2203830000",
      "sum": "75.76",
      "country": "220"
    },
    {
      "id": "40516576",
      "number": "2203830001",
      "sum": "58.76",
      "country": "220"
    }
  ]
}
401Kein API-Schlüssel, oder der Schlüssel existiert nicht. Der Body ist der reine Text Unauthorized. Eine Anfrage mit Accept: application/json erhält stattdessen HTTP 200 mit {"response":"ERROR_WRONG_KEY"}.
Content-Typetext/html
Schema
schemastring
Enumeration:Unauthorized.Beispiel:Unauthorized.
403Verboten: Der API-Schlüssel ist gültig, aber die Anfrage wird abgelehnt. Fehlercodes:
  • ERROR_DISABLED — das Partnerkonto ist nicht aktiviert;
  • ERROR_BANNED — das Partnerkonto ist gesperrt;
  • ERROR_IP — die Anfrage kommt von einer IP-Adresse, die nicht auf der Positivliste des Kontos steht;
  • ERROR_RENT — rent wird angefordert, aber das Konto hat keinen Mietzugang (nur addNumber).
Content-Typeapplication/json
Schema
schemaobject
responsestringErforderlich
FehlercodeEnumeration:ERROR_DISABLEDERROR_BANNEDERROR_IPERROR_RENT
messagestringErforderlich
Derselbe Fehlercode

Beispiele

ERROR_IP

Anfrage von einer IP-Adresse außerhalb der Positivliste

{
  "response": "ERROR_IP",
  "message": "ERROR_IP"
}

Codebeispiele

Beispiele werden generiert...