Upcoming changes to api commands for. It




Yüklə 146.91 Kb.
tarix28.02.2016
ölçüsü146.91 Kb.

Upcoming changes to API commands for .IT


On February 3, 2011, OpenSRS is transitioning .IT domain registration and management to the Extensible Provisioning Protocol (EPP) interface. The Horizon Test Environment will be transitioned to EPP two weeks earlier on January 20, 2011 to allow you to test against the new interface.

Due to the changes and additions to the data that will be required by the .IT registry, we have had to make some changes to the OpenSRS API for ordering and managing .IT domains.



Important: These changes are not backwards compatible, and therefore, you will need to make changes to your API integrations before the cutover date or those integrations will no longer work.

This document outlines the new and changed requirements for .IT domains including the following:



  • sw_register—The .IT owner contact requires three additional parameters: nationality_code, reg_code, and entity_type.

  • modify—The .IT owner contact requires three additional parameters: nationality_code, reg_code, and entity_type.

  • advanced_update_nameservers—The .IT registry runs a series of tests against the nameservers before activating them.

  • update_all_info—This command can no longer be used for .IT domains.

  • update_contacts—The .IT owner contact requires three additional parameters: nationality_code, reg_code, and entity_type.

For complete explanations of these commands, please refer to the OpenSRS API Specification, which is available at http://opensrs.com/resources/domains/documentation/

.IT contact requirements


Parameter name

Obligation

Format/Constraints

first_name

Required

Maximum length: 64 alphanumeric characters.

last_name

Required

Maximum length: 64 alphanumeric characters.

org_name

Required if entity_type = 1

Maximum length: 64 alphanumeric characters.

address1

Required

Maximum length: 100 alphanumeric characters.

address2

Optional

Maximum length: 100 alphanumeric characters.

address3

Optional

Maximum length: 100 alphanumeric characters.

city

Required

Maximum length: 64 alphanumeric characters.

state

Required

Maximum length: 32 alphanumeric characters.  

If country = IT, province must be a valid Italian province. (See http://en.wikipedia.org/wiki/ISO_3166-2:IT).



postal_code

Required

Maximum length: 16 alphanumeric characters. 

If country = IT, postal_code must be a valid Italian postal code. (See http://en.wikipedia.org/wiki/List_of_postal_codes_in_Italy)



country

Required

The ISO 3166-1 country code for the owner contact. Maximum length: 2 alphanumeric characters. (See nationality_code for requirements.)

Note: Be sure to use capital letters.

phone

Required

Maximum length: 20 alphanumeric characters, in the format +CCC.NNNNNNNNNNxEEEE, where C = country code, N = phone number, and E = extension (optional).

fax

Optional

Maximum length: 20 alphanumeric characters, if not null syntax verified according to EPP.

email

Required

Maximum length: 100 alphanumeric characters, validated according to rfc822.

entity_type

Required

A numeric entry that indicates the type of domain owner.

Valid values are:



  • 1—Italian and foreign natural persons

  • 2—Companies/one man companies

  • 3—Freelance workers/professionals

  • 4—Non-profit organizations

  • 5—Public organizations

  • 6—Other subjects

  • 7—Foreigners who match 2-6

nationality_code

Optional

The ISO 3166-1 code for the nationality of the domain owner. Maximum length: 2 alphanumeric characters.

If entity_type = 1, nationality or owner's country or both must be an EU country.

If entity_type = 2-6, this value must be IT.

If entity_type = 7, this value must match owner's country and must be an EU country other than IT.



Note: Be sure to use capital letters.

reg_code

Required

An identifying number, usually the VAT or Codice Fiscale (numeric tax code). The value that you need to enter depends on the entity type of the registrant.

  • Italian citizens must enter their Codice Fiscale.

  • Non Italians not living in Italy can enter n.a.

  • Italian companies, freelancers, and other subjects must enter their 11 digit VAT number or tax indentification number.

  • Italian non-profit organizations must enter their VAT number or tax identification number; however, if they do not have one,they can enter n.a.

  • Non Italian entities other than persons (organizations, freelancers, companies, etc.) may enter their VAT number or n.a.

 

sw_register command


Specific parameters and required values for .IT

Parameters within the attributes associative array are described below.



Parameter name

Obligation

Definition/Value

change_contact

Optional

Used to change contact information during a transfer or after transfer completion.

0 = do not change contact set.

1 = apply a new contact set when transfer completes.

Important: For .IT transfers, if change_contact = 1, then you must also include a tld_data associative array.

owner_confirm_address

Required for.IT transfers

The email address to which to send messages regarding a .BE, .DE, .EU or .IT transfer.

Note: The email address provided is used for the current transfer only, and not for future messages.

tld_data

Required

An associative array containing the it_registrant_info associative array which designates the residency of the registrant.

For more information, see the it_registrant_info table below.



 

it_registrant_info

The it_registrant_info associative array within the tld_data associative array contains information to satisfy the regional presence requirements of the .IT registry.



Parameter name

Obligation

Definition/Value

entity_type

Required

Specify the legal entity type of registrant.

Allowed values are:



  • 1—Italian and foreign natural persons

  • 2—Companies/one man companies

  • 3—Freelance workers/professionals

  • 4—Non-profit organizations

  • 5—Public organizations

  • 6—Other subjects

  • 7—Foreigners who match 2-6

nationality_code

Optional

Enter the 2-digit ISO 3166-1 code that identifies the Registrant's nationality.

If entity_type = 1, nationality or owner's country or both must be an EU country.

If entity_type = 2-6, this value must be IT.

If entity_type = 7, this value must match owner's country and must be an EU country other than IT.



Note: Be sure to use capital letters.

reg_code

Required

An identifying number, usually the VAT or Codice Fiscale (numeric tax code). The value that you need to enter depends on the entity type of the registrant.

  • Italian citizens must enter their Codice Fiscale.

  • Non Italians not living in Italy can enter n.a.

  • Italian companies, freelancers, and other subjects must enter their 11 digit VAT number or tax indentification number.

  • Italian non-profit organizations must enter their VAT number or tax identification number; however, if they do not have one,they can enter n.a.

  • Non Italian entities other than persons (organizations, freelancers, companies, etc.) may enter their VAT number or n.a.

 

Examples for sw_register when domain = .IT


Request

This example registers a domain to a person (entity_code=1). In this case, the admin contact does not need to be defined as it must be the same as the owner; if the admin contact is specified, it is ignored. Similarly, org_name is not required in this instance, and if specified, is ignored.





 

  0.9

  

 

  



   

    XCP

    SW_REGISTER

    DOMAIN

    

     

      aaaa

      

       

        

         

          IT

          SGLMRA80A01H501E

          1

         

        

       

      

      1

      aaaa

      1

      0

      0

      1

      0

      example031.it

      new

      

      

       

        

         

          Mario

          Segale

          Mario Segale

          Via del Campidoglio, 1

          Rome

          RM

          IT

          00123

          +39.0612345678

          mario@mail.it

         

        

        

         

          Frank

          Mosser

          Tech Orgname

          Piazza dei Giudici 1

          Firenze

          FI

          IT

          50123

          +39.0551234567

          qafive@example.com

         

        

       

      

      

       

        

         

          ns1.mdnsservice.com

          1

         

        

        

         

          ns2.mdnsservice.com

          2

         

        

        

         

          ns3.mdnsservice.com

          3

         

        

       

      

     

    

   

  



 


Verilənlər bazası müəlliflik hüququ ilə müdafiə olunur ©azrefs.org 2016
rəhbərliyinə müraciət

    Ana səhifə