Logo .id PANDIDokumentasi PengembangPANDI EPP
PANDI · REFERENSI PENGEMBANG EPP

poll

poll op=req mengambil pesan asynchronous. Setelah berhasil diproses, poll op=ack dengan msgID menghapus pesan dari queue.

poll op=req retrieves an asynchronous message. After successful processing, poll op=ack with msgID removes it from the queue.

Cara kerja

poll op=req mengambil pesan asynchronous. Setelah berhasil diproses, poll op=ack dengan msgID menghapus pesan dari queue.

  1. Ambil satu pesan, proses secara idempoten, lalu kirim ack.
  2. Jangan ack sebelum data notifikasi tersimpan dengan aman.
  3. Jika tidak ada pesan, server dapat mengembalikan 1300.

How it works

poll op=req retrieves an asynchronous message. After successful processing, poll op=ack with msgID removes it from the queue.

  1. Fetch one message, process it idempotently, then acknowledge it.
  2. Do not acknowledge before safely storing the notification.
  3. An empty queue can return code 1300.

Permintaan dan respons XML

Contoh XML bersifat ilustratif, menggunakan identitas dan domain contoh. Jangan kirim nilainya ke server produksi.

XML permintaan

XML · Permintaan
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1" xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0">
  <command>
    <poll op="req"/>
    <clTRID>REG-EXAMPLE-0001</clTRID>
  </command>
</epp>

XML respons

XML · Respons
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1" xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0">
  <response>
    <result code="1301"><msg>Command completed successfully; ack to dequeue</msg></result>
    <trID><clTRID>REG-EXAMPLE-0001</clTRID><svTRID>SERVER-EXAMPLE-0001</svTRID></trID>
  </response>
</epp>