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.
- Ambil satu pesan, proses secara idempoten, lalu kirim ack.
- Jangan ack sebelum data notifikasi tersimpan dengan aman.
- 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.
- Fetch one message, process it idempotently, then acknowledge it.
- Do not acknowledge before safely storing the notification.
- 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>