Skip to main content

This page has been translated using TexTra by NICT. Please note that the translation may not be completely accurate.If you find any mistranslations, we appreciate your feedback on the "Request form for improving the automatic translation ".

Laws and ordinances API prototype public testing (Part 3)

Published:

1. Overview

Purpose of the meeting

Digital Agency is working on upgrading the laws and ordinances API, which provides information on laws, government and ministerial ordinances, with the aim of developing industry, technology and policy planning through the use of laws and ordinances information. We aim to improve the API by the end of fiscal 2024.
In order to advance the laws and ordinances API, we developed a prototype of the laws and ordinances API function enhancement (laws and ordinances API prototype) and conducted public tests on the following schedule.

  • Public Testing (Part 1): October - November 2023
  • Public Testing (2nd round): February - March 2024

We will make further improvements to the laws and ordinances API prototype and conduct the third public test in conjunction with the "laws and ordinances" × "Digital" Hackathon . Please use the prototype for trial and let us know your frank opinions.

2. Period

Twenty twenty-five From January 27 (Mon) to February 21 (Fri) twenty twenty-five

3. How to use

The laws and ordinances API prototype is an API prototype that extends the functions of the "Digital Agency API" currently provided by laws and ordinances on the e-Gov laws and ordinances Search.

in fiscal 2023 (end) laws and ordinances API prototype open test (2nd) was equipped with a function to obtain a list and text of laws and ordinances. In this laws and ordinances API prototype open test (3rd), we added a function to search for text at a specific point in time and obtain the text at that point in time based on laws and ordinances and other data in the e-Gov laws and ordinances search (hereinafter, the API including this function is referred to as "laws and ordinances API Version2").
In fiscal 2024, in addition to the "laws and ordinances API Version2" mentioned above, we developed a prototype of an API with a function that can obtain some notification information (hereinafter, the API including this function is referred to as the "Notification / Intermediate API").

You can check the usage environments of each API of "laws and ordinances API Version2" and "Announcement / Intermediate API" provided in this public test from the following URL.

  • Laws and ordinances API Version2
    By specifying a time point, past articles can be searched and articles can be retrieved. In addition to the XML format conforming to the laws and ordinances Standard XML Schema, laws and ordinances article data is also provided in the JSON format on an experimental basis. However, please note that the JSON format specifications are provisional with the aim of being interconvertible with XML conforming to the laws and ordinances Standard XML Schema.
    • API Specifications and Usage Environment (Swagger UI)
      You can check the URL and parameters of the API.
      In addition, in the "Introduction" section at the beginning, we provide a page that explains the range of laws and ordinances information provided by the API, laws and ordinances structure, etc., so please make use of it.
  • Notification and intermediate API
    In the notification API, it is possible to obtain notification data (XML format and plain text format conforming to the laws and ordinances standard XML schema) on a trial basis for some notifications in the architectural field, and it is possible to obtain laws and ordinances data (laws and ordinances ID and laws and ordinances name) linked to arbitrary notification data.

4. Points to Note

  • Please note that the data that can be obtained from this prototype API is prepared for the purpose of testing, and the completeness cannot be guaranteed.
  • This prototype is provided as a temporary test, so please refrain from incorporating it into the actual system.
  • When using the laws and ordinances API for actual service provision as a project using the laws and ordinances API, please note that it is necessary to use the current API officially provided on the laws and ordinances e-Gov or the laws and ordinances API after the renovation that is being considered in the future. laws and ordinances

5. Terms of Use

  1. About Access Restrictions
    This environment adopts a disclosure method that does not require special use procedures or authentication so that it can be accessed by as many users as possible. However, in order to protect the server, if we confirm a large amount of access exceeding the processing limit of the server or BOT access, we may restrict access. Please refrain from using it by intentionally doing something like a load test.
    In addition, please refrain from using the method of sequentially acquiring text data by looping through all the laws and ordinances, as it burdens the server resources and causes response delays and server downtime that can affect other users.
    If you need to download the information in bulk, please refer to "XML Bulk Download" in the laws and ordinances User Environments section of " API Version2".
  2. Handling of provided URLs
    The URL can only be accessed during the period of the event. Access to the URL will not be possible outside the period of the event. Therefore, please refrain from using the URL for services that are intended to be used permanently and posting the link on the website. In addition, Digital Agency will not be responsible for any disadvantages that may arise on the part of the user in using the URL.
  3. About Maintenance
    Laws and ordinances API prototypes will not be available during server maintenance. We will notify you on the Digital Agency website when we conduct server maintenance that requires a long-term outage. Please note that API specifications may also change during the event.
  4. About Service Interruptions
    If an event occurs that Digital Agency determines to be unavoidable, we may suspend the disclosure of this environmental event even during the period of the event.

Gyosei Co., Ltd., which is the contractor, is engaged in the development of this prototype, the provision of tests, and the tabulation of opinions received.

6. Privacy Policy

Privacy Policy for the laws and ordinances × Digital hackathon and the laws and ordinances API Prototype Open Testing (PDF / 246 kb)

7. Inquiries

If you have any comments such as how it feels to actually use the laws and ordinances API prototype, or if there are any problems or unclear points, please contact us through the "laws and ordinances" × "Digital" hackathon and the laws and ordinances API prototype open test contact form .
Please note that not all of the comments received during the previous test have been completely corrected. Please contact us if you have any questions, even if they are duplicated.

Related Links

Share: