internetee-registry/doc/epp/contact.md
2015-03-10 17:44:18 +02:00

6.4 KiB

Please study official Contact Mapping protocol: http://tools.ietf.org/html/rfc5733

More info at http://en.wikipedia.org/wiki/Extensible_Provisioning_Protocol

Contact Mapping protocol short version:

Contact create

Field name                 Min-max  Field description
-----------------------    -------  -----------------
<create>                   1     
  <contact:create>         1        Attribute: xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
    <contact:id>           0-1      Contact id, optional, generated automatically if missing
    <contact:postalInfo>   1        Postal information container
      <contact:name>       1        Full name of the contact
      <contact:org>        0        Org is not supported and should be blank or missing
      <contact:addr>       1        Address container
        <contact:street>   0-n      Street name
        <contact:city>     1        City name
        <contact:sp>       0-1      State or province
        <contact:pc>       0-1      Postal code
        <contact:cc>       1        Country code, 2 letters uppercase, in ISO_3166-1 alpha 2
    <contact:voice>        1        Phone number in format \+ddd.d+
    <contact:email>        1        E-mail
<extension>                1       
  <eis:extdata>            1        Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
    <eis:ident>            1        Contact identificator 
                                      Attribute: type="bic/priv/birthday"
                                      "bic"          # Business registry code
                                      "priv"         # National idendtification number
                                      "birthday"     # Birthday date in format in DD-MM-YYYY
    <eis:legalDocument>    0-1      Base64 encoded document 
                                      Attribute: type="pdf/bdoc/ddoc/zip/rar/gz/tar/7z"
<clTRID>                   0-1      Client transaction id

EXAMPLE REQUEST AND RESPONSE

Contact update

Field name                  Min-max  Field description
-----------------------     -------  -----------------
<update>                    1     
  <contact:update>          1        Attribute: xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
    <contact:id>            1        Contact id, required
    <contact:chg>           1        Change container
      <contact:postalInfo>  1        Postal information container
        <contact:name>      0-1      Full name of the contact
        <contact:org>       0        Org is not supported and should be blank or missing
        <contact:addr>      0-1      Address container
          <contact:street>  0-n      Street name
          <contact:city>    0-1      City name
          <contact:sp>      0-1      State or province
          <contact:pc>      0-1      Postal code
          <contact:cc>      0-1      Country code, 2 letters uppercase, in ISO_3166-1 alpha 2
      <contact:voice>       0-1      Phone number in format \+ddd.d+
      <contact:email>       0-1      E-mail
    <contact:authInfo>      0-1      Required if registrar is not the owner of the contact.
      <contact:pw>          1        Contact password. Attribute: roid="String"
<extension>                 0-1       
  <eis:extdata>             0-1      Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
    <eis:ident>             0-1      Contact identificator 
                                       Attribute: type="bic/priv/birthday"
                                       "bic"         # Business registry code
                                       "priv"        # National idendtification number
                                       "birthday"    # Birthday date in format in DD-MM-YYYY
    <eis:legalDocument>     0-1      Base64 encoded document. 
                                       Attribute: type="pdf/bdoc/ddoc/zip/rar/gz/tar/7z"
<clTRID>                    0-1      Client transaction id

EXAMPLE REQUEST AND RESPONSE

Contact delete

Field name                Min-max  Field description
-----------------------   -------  -----------------
<delete>                  1       
  <contact:delete>        1        Attribute: xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
    <contact:id>          1        Contact id
    <contact:authInfo>    0-1      Required if registrar is not the owner of the contact.
      <contact:pw>        1        Contact password. Attribute: roid="String"
<extension>               0-1       
  <eis:extdata>           0-1      Attribute: xmlns:eis="urn:ee:eis:xml:epp:eis-1.0"
    <eis:legalDocument>   0-1      Base64 encoded document. 
                                     Attribute: type="pdf/bdoc/ddoc/zip/rar/gz/tar/7z"
<clTRID>                  0-1      Client transaction id

EXAMPLE REQUEST AND RESPONSE

Contact check

Field name               Min-max  Field description
-----------------------  -------  -----------------
<check>                  1       
  <contact:check>        1        Attribute: xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
    <contact:id>         1-n      Contact id 
<clTRID>                 0-1      Client transaction id

EXAMPLE REQUEST AND RESPONSE

Contact info

Field name               Min-max  Field description
-----------------------  -------  -----------------
<info>                   1       
  <contact:info>         1        Attribute: xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
    <contact:id>         1-n      Contact id 
    <contact:authInfo>   0-1      Required if registrar is not the owner of the contact.
      <contact:pw>       1        Contact password. Attribute: roid="String"
<clTRID>                 0-1      Client transaction id

EXAMPLE REQUEST AND RESPONSE