# Alterar a rotação

## **Ponto final:**

`POST https://proxy-seller.com/personal/api/v1/{YourApiKey}/residentsubuser/list/rotation`

## **Parâmetros de caminho:**

| Nome | Valor | Descrição |
| --- | --- | --- |
| Autorização | `<Your_API_Key>` | Sua chave de API pessoal |

## **Corpo da solicitação:**

| Nome | Tipo | Descrição |
| --- | --- | --- |
| id | Número | Id da lista criada |
| rotação | Número | O novo valor de rotação que você deseja definir, "-1" - sem rotação (Sticky), "0" - rotação por solicitação, "1"-"3600" - rotação por tempo em segundos |
| package_key | Cordas | Chave do pacote de um subusuário no qual você deseja alterar a rotação |

### **Exemplo:**

```
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/residentsubuser/list/rotation
```

## **Resposta:**

**200: OK Resposta bem-sucedida**

```json
{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "whitelist": "127.0.0.1,192.168.0.1",
    "rotation": "-1 = rotation, 0 = rotation per request, 1..3600 time in seconds",
    "geo": {
      "country": "US",
      "region": "Washington",
      "city": "Garfield",
      "isp": "FIRST-STEP"
    },
    "export": {
      "ports": 10000,
      "ext": "txt"
    }
  },
  "errors": []
}
```

**200: OK Resposta de erro Chave de API incorreta**

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}
```

**200: OK Resposta de erro IP de autorização incorreto**

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        }
    ]
}
```

**200: OK Resposta de erro Lista não encontrada**

```json
Same response in case with wrong rotation!

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "not-found",
            "code": 404,
            "customData": null
        },
        {
            "message": "not-found (404)",
            "code": 0,
            "customData": null
        }
    ]
}
```

**200: OK Resposta de erro Tarifa não encontrada**

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Tarif not found",
            "code": 0,
            "customData": null
        }
    ]
}
```