Como usar proxies com o Postman: guia completo

TL;DR

Configure proxies GProxy no Postman para testar APIs a partir de diferentes localizações. Cobre configurações globais de proxy, configuração por requisição e variáveis de ambiente.

Obter proxies → Postman site →

Idioma: GUI / API Client

Pré-requisitos

✓[
✓"
✓A
✓p
✓l
✓i
✓c
✓a
✓t
✓i
✓v
✓o
✓
✓d
✓e
✓s
✓k
✓t
✓o
✓p
✓
✓d
✓o
✓
✓P
✓o
✓s
✓t
✓m
✓a
✓n
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓a
✓d
✓o
✓"
✓,
✓
✓"
✓C
✓o
✓n
✓t
✓a
✓
✓G
✓P
✓r
✓o
✓x
✓y
✓
✓c
✓o
✓m
✓
✓p
✓l
✓a
✓n
✓o
✓
✓d
✓e
✓
✓p
✓r
✓o
✓x
✓y
✓
✓a
✓t
✓i
✓v
✓o
✓"
✓,
✓
✓"
✓F
✓a
✓m
✓i
✓l
✓i
✓a
✓r
✓i
✓d
✓a
✓d
✓e
✓
✓b
✓á
✓s
✓i
✓c
✓a
✓
✓c
✓o
✓m
✓
✓r
✓e
✓q
✓u
✓i
✓s
✓i
✓ç
✓õ
✓e
✓s
✓
✓e
✓
✓c
✓o
✓l
✓e
✓ç
✓õ
✓e
✓s
✓
✓d
✓o
✓
✓P
✓o
✓s
✓t
✓m
✓a
✓n
✓"
✓]

Configuração passo a passo

[

{

"

T

I

T

L

E

"

:

"

A

B

R

A

S

C

O

N

F

I

G

U

R

A

Ç

Õ

E

S

D

E

P

R

O

X

Y

D

O

P

O

S

T

M

A

N

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

V

Á

E

M

S

E

T

I

N

G

S

>

P

R

O

X

Y

"

,

"

C

100

O

101

D

102

E

103

"

104

:

105

106

"

107

S

108

E

109

T

110

T

111

I

112

N

113

G

114

S

115

116

(

117

Í

118

C

119

O

120

N

121

E

122

123

D

124

E

125

126

E

127

N

128

G

129

R

130

E

131

N

132

A

133

G

134

E

135

M

136

)

137

138

→

139

140

P

141

R

142

O

143

X

144

Y

145

146

→

147

148

A

149

T

150

I

151

V

152

E

153

154

'

155

U

156

S

157

E

158

159

C

160

U

161

S

162

T

163

O

164

M

165

166

P

167

R

168

O

169

X

170

Y

171

172

C

173

O

174

N

175

F

176

I

177

G

178

U

179

R

180

A

181

T

182

I

183

O

184

N

185

'

186

"

187

}

188

,

189

190

{

191

"

192

T

193

I

194

T

195

L

196

E

197

"

198

:

199

200

"

201

C

202

O

203

N

204

F

205

I

206

G

207

U

208

R

209

E

210

211

A

212

213

G

214

P

215

R

216

O

217

X

218

Y

219

"

220

,

221

222

"

223

D

224

E

225

S

226

C

227

R

228

I

229

P

230

T

231

I

232

O

233

N

234

"

235

:

236

237

"

238

I

239

N

240

F

241

O

242

R

243

M

244

E

245

246

O

247

S

248

249

D

250

A

251

D

252

O

253

S

254

255

D

256

O

257

258

P

259

R

260

O

261

X

262

Y

263

264

G

265

P

266

R

267

O

268

X

269

Y

270

"

271

,

272

273

"

274

C

275

O

276

D

277

E

278

"

279

:

280

281

"

282

P

283

R

284

O

285

X

286

Y

287

288

S

289

E

290

R

291

V

292

E

293

R

294

:

295

296

P

297

R

298

O

299

X

300

Y

301

.

302

G

303

P

304

R

305

O

306

X

307

Y

308

.

309

N

310

E

311

T

312

\

313

N

314

P

315

O

316

R

317

T

318

:

319

320

1

321

0

322

0

323

0

324

\

325

N

326

P

327

R

328

O

329

X

330

Y

331

332

A

333

U

334

T

335

H

336

:

337

338

O

339

N

340

\

341

N

342

U

343

S

344

E

345

R

346

N

347

A

348

M

349

E

350

:

351

352

Y

353

O

354

U

355

R

356

_

357

U

358

S

359

E

360

R

361

\

362

N

363

P

364

A

365

S

366

S

367

W

368

O

369

R

370

D

371

:

372

373

Y

374

O

375

U

376

R

377

_

378

P

379

A

380

S

381

S

382

"

383

}

384

,

385

386

{

387

"

388

T

389

I

390

T

391

L

392

E

393

"

394

:

395

396

"

397

C

398

R

399

I

400

E

401

402

V

403

A

404

R

405

I

406

Á

407

V

408

E

409

I

410

S

411

412

D

413

E

414

415

A

416

M

417

B

418

I

419

E

420

N

421

T

422

E

423

"

424

,

425

426

"

427

D

428

E

429

S

430

C

431

R

432

I

433

P

434

T

435

I

436

O

437

N

438

"

439

:

440

441

"

442

G

443

U

444

A

445

R

446

D

447

E

448

449

A

450

451

C

452

O

453

N

454

F

455

I

456

G

457

U

458

R

459

A

460

Ç

461

Ã

462

O

463

464

D

465

E

466

467

P

468

R

469

O

470

X

471

Y

472

473

E

474

M

475

476

V

477

A

478

R

479

I

480

Á

481

V

482

E

483

I

484

S

485

486

P

487

A

488

R

489

A

490

491

T

492

R

493

O

494

C

495

A

496

R

497

498

F

499

A

500

C

501

I

502

L

503

M

504

E

505

N

506

T

507

E

508

"

509

,

510

511

"

512

C

513

O

514

D

515

E

516

"

517

:

518

519

"

520

P

521

R

522

O

523

X

524

Y

525

_

526

H

527

O

528

S

529

T

530

:

531

532

P

533

R

534

O

535

X

536

Y

537

.

538

G

539

P

540

R

541

O

542

X

543

Y

544

.

545

N

546

E

547

T

548

\

549

N

550

P

551

R

552

O

553

X

554

Y

555

_

556

P

557

O

558

R

559

T

560

:

561

562

1

563

0

564

0

565

0

566

\

567

N

568

P

569

R

570

O

571

X

572

Y

573

_

574

U

575

S

576

E

577

R

578

:

579

580

Y

581

O

582

U

583

R

584

_

585

U

586

S

587

E

588

R

589

\

590

N

591

P

592

R

593

O

594

X

595

Y

596

_

597

P

598

A

599

S

600

S

601

:

602

603

Y

604

O

605

U

606

R

607

_

608

P

609

A

610

S

611

S

612

"

613

}

614

,

615

616

{

617

"

618

T

619

I

620

T

621

L

622

E

623

"

624

:

625

626

"

627

T

628

E

629

S

630

T

631

E

632

633

O

634

635

P

636

R

637

O

638

X

639

Y

640

"

641

,

642

643

"

644

D

645

E

646

S

647

C

648

R

649

I

650

P

651

T

652

I

653

O

654

N

655

"

656

:

657

658

"

659

E

660

N

661

V

662

I

663

E

664

665

U

666

M

667

A

668

669

R

670

E

671

Q

672

U

673

I

674

S

675

I

676

Ç

677

Ã

678

O

679

680

P

681

A

682

R

683

A

684

685

V

686

E

687

R

688

I

689

F

690

I

691

C

692

A

693

R

694

695

S

696

E

697

698

O

699

700

P

701

R

702

O

703

X

704

Y

705

706

E

707

S

708

T

709

Á

710

711

F

712

U

713

N

714

C

715

I

716

O

717

N

718

A

719

N

720

D

721

O

722

"

723

,

724

725

"

726

C

727

O

728

D

729

E

730

"

731

:

732

733

"

734

G

735

E

736

T

737

738

H

739

T

740

T

741

P

742

S

743

:

744

/

745

/

746

H

747

T

748

T

749

P

750

B

751

I

752

N

753

.

754

O

755

R

756

G

757

/

758

I

759

P

760

\

761

N

762

\

763

N

764

R

765

E

766

S

767

P

768

O

769

S

770

T

771

A

772

773

E

774

S

775

P

776

E

777

R

778

A

779

D

780

A

781

:

782

\

783

N

784

{

785

\

786

"

787

O

788

R

789

I

790

G

791

I

792

N

793

\

794

"

795

:

796

797

\

798

"

799

<

800

P

801

R

802

O

803

X

804

Y

805

_

806

I

807

P

808

>

809

\

810

"

811

}

812

"

813

}

814

,

815

816

{

817

"

818

T

819

I

820

T

821

L

822

E

823

"

824

:

825

826

"

827

U

828

S

829

E

830

831

O

832

833

N

834

E

835

W

836

M

837

A

838

N

839

840

C

841

L

842

I

843

844

C

845

O

846

M

847

848

P

849

R

850

O

851

X

852

Y

853

"

854

,

855

856

"

857

D

858

E

859

S

860

C

861

R

862

I

863

P

864

T

865

I

866

O

867

N

868

"

869

:

870

871

"

872

E

873

X

874

E

875

C

876

U

877

T

878

E

879

880

C

881

O

882

L

883

E

884

Ç

885

Õ

886

E

887

S

888

889

C

890

O

891

M

892

893

P

894

R

895

O

896

X

897

Y

898

899

P

900

E

901

L

902

A

903

904

L

905

I

906

N

907

H

908

A

909

910

D

911

E

912

913

C

914

O

915

M

916

A

917

N

918

D

919

O

920

"

921

,

922

923

"

924

C

925

O

926

D

927

E

928

"

929

:

930

931

"

932

E

933

X

934

P

935

O

936

R

937

T

938

939

H

940

T

941

T

942

P

943

_

944

P

945

R

946

O

947

X

948

Y

949

=

950

H

951

T

952

T

953

P

954

:

955

/

956

/

957

U

958

S

959

E

960

R

961

:

962

P

963

A

964

S

965

S

966

@

967

P

968

R

969

O

970

X

971

Y

972

.

973

G

974

P

975

R

976

O

977

X

978

Y

979

.

980

N

981

E

982

T

983

:

984

1

985

0

986

0

987

0

988

\

989

N

990

N

991

E

992

W

993

M

994

A

995

N

996

997

R

998

U

999

N

1000

1001

C

1002

O

1003

L

1004

L

1005

E

1006

C

1007

T

1008

I

1009

O

1010

N

1011

.

1012

J

1013

S

1014

O

1015

N

1016

"

1017

}

1018

]

Exemplos de código

Por que usar proxies com o Postman?

O Postman é a plataforma mais popular de desenvolvimento e testes de API. Adicionar proxies GProxy ao Postman permite testar respostas de API a partir de diferentes localizações geográficas, verificar o comportamento de rate limiting e depurar endpoints com restrição geográfica — tudo em uma interface visual. Os 10M+ de IPs residenciais da GProxy em 150+ países dão a você capacidade global de testes de API.

Configuração global de proxy

O Postman suporta configurações globais de proxy que se aplicam a todas as requisições. Vá em Settings > Proxy para configurar a GProxy como seu proxy padrão. É ideal para sessões de teste em que todas as requisições devem passar pelo mesmo endpoint de proxy.

Proxy por requisição

Para um controle mais granular, use os pre-request scripts do Postman para definir o proxy por requisição ou por coleção. Isso permite testar o mesmo endpoint de API a partir de várias localizações em uma única execução da coleção.

Usando variáveis de ambiente

Guarde suas credenciais GProxy em variáveis de ambiente do Postman para alternar facilmente entre configurações de proxy. Crie variáveis para host, porta, usuário e senha do proxy e depois referencie-as nas configurações de proxy.

Collection Runner com proxy

Execute coleções inteiras de testes de API através dos proxies GProxy usando o Collection Runner. É perfeito para testes automatizados de APIs geodependentes, validação de rate limit e checagens de disponibilidade em várias localizações.

Postman + Newman CLI

Para integração com CI/CD, use o Newman (o CLI do Postman) com variáveis de ambiente de proxy do sistema para rotear todas as requisições pela GProxy. Isso viabiliza pipelines automatizados de teste de API com suporte a proxy.

Casos de uso

[

{

"

T

I

T

L

E

"

:

"

T

E

S

T

E

S

D

E

A

P

I

P

O

R

G

E

O

L

O

C

A

L

I

Z

A

Ç

Ã

O

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

E

S

T

E

C

O

M

O

A

S

A

P

I

S

R

E

S

P

O

N

D

E

M

A

R

E

Q

U

I

S

I

Ç

Õ

E

S

D

E

D

I

F

E

R

E

N

T

E

S

P

A

Í

S

E

S

U

S

A

N

D

O

S

P

R

O

X

I

E

S

G

E

O

-

S

E

G

M

E

N

T

A

D

O

S

D

A

G

P

R

O

X

Y

.

"

}

,

{

"

T

I

T

L

E

"

:

"

T

E

S

T

E

D

E

R

A

T

E

L

I

M

I

T

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

V

E

R

I

F

I

Q

U

E

O

C

O

M

P

O

R

T

A

M

E

N

T

O

D

E

R

A

T

E

L

I

M

I

T

I

N

G

E

N

V

I

A

N

D

O

R

E

Q

U

I

S

I

Ç

Õ

E

S

D

E

V

Á

R

I

O

S

I

P

S

P

O

R

M

E

I

O

D

A

R

O

T

A

Ç

Ã

O

D

E

P

R

O

X

I

E

S

.

"

}

,

{

"

T

I

T

L

E

"

:

"

D

E

P

U

R

A

Ç

Ã

O

D

E

W

E

B

H

O

K

S

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

D

E

P

U

R

E

W

E

B

H

O

K

S

R

E

C

E

B

I

D

O

S

R

O

T

E

A

N

D

O

C

H

A

M

A

D

A

S

D

E

T

E

S

T

E

P

O

R

D

I

F

E

R

E

N

T

E

S

I

P

S

D

E

P

R

O

X

Y

.

"

}

,

{

"

T

I

T

L

E

"

:

"

T

E

S

T

E

S

D

E

S

E

G

U

R

A

N

Ç

A

D

E

A

P

I

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

T

E

S

T

E

O

S

C

O

N

T

R

O

L

E

S

D

E

S

E

G

U

R

A

N

Ç

A

D

A

P

I

C

O

N

T

R

A

R

E

Q

U

I

S

I

Ç

Õ

E

S

V

I

N

D

A

S

D

E

D

I

V

E

R

S

A

S

F

A

I

X

A

S

D

E

I

P

E

L

O

C

A

L

I

Z

A

Ç

Õ

E

S

.

"

}

]

Dicas Pro

Use os environments do Postman para alternar entre configurações de proxy (EUA, UE, Ásia). Guarde as credenciais GProxy como variáveis de ambiente, não fixas no código. Use o Newman em pipelines de CI com a variável de ambiente HTTP_PROXY. Teste a mesma coleção a partir de várias localizações usando configurações de proxy diferentes.