@kintone/rest-api-client-dingtalk-mp

kintone-rest-api-client-dingtalk-mp

An API client for Kintone REST API, it is used in DingTalk Mini Program client.
It is based on @kintone/rest-api-client@v1.2.0.
It wraps the functions of app, record and bulkRequest of "@kintone/rest-api-client", and develops the new functions of file.

Requirement

• DingTalk Developer Tool (The latest)
  

Usage

Step 1

Open DingTalk Developer Tool and create a new project. (Ref. 小程序IDE使用)

Step 2

Install with npm

cd [your-project-directory]
npm init -y
npm install @kintone/rest-api-client-dingtalk-mp

Sample code

const {KintoneRestAPIClientDingTalkMP} = require('@kintone/rest-api-client-dingtalk-mp');
const client = new KintoneRestAPIClientDingTalkMP({
  baseUrl: "https://example.cybozu.com",
  // Use password authentication
  auth: {
    username: process.env.KINTONE_USERNAME,
    password: process.env.KINTONE_PASSWORD,
  },
  // Use API token authentication
  // auth: { apiToken: process.env.KINTONE_API_TOKEN }
});

client.record
  .getRecords({ app: "1" })
  .then((resp) => {
    console.log(resp.records);
  })
  .catch((err) => {
    console.log(err);
  });

Parameters for KintoneRestAPIClientDingTalkMP

Name	Type	Required	Description
baseUrl	String	Required	The base URL for your Kintone environment. It must start with https. (e.g. https://example.kintone.com)
auth	Object	Required	The object for authentication. See Authentication.
guestSpaceId	Number or String		The guest space ID. If you are dealing with apps that are in guest spaces, please specify this.
basicAuth	Object		If your Kintone environment uses Basic authentication, please specify its username and password.
basicAuth.username	String		The username of Basic authentication.
basicAuth.password	String		The password of Basic authentication.

Authentication

The client supports three authentication methods:

1. Password authentication
2. API token authentication

The required parameters inside auth are different by the methods. The client determines which method to use by passed parameters.

1. Parameters for Password authentication

Name	Type	Required	Description
username	String	Yes	User's login name
password	String	Yes	User's password

2. Parameters for API token authentication

Name	Type	Required	Description
apiToken	String or String[]	Yes	You can pass multiple api tokens as an array of string.

References

• File

The usage of following functions is not changed, you can refer to the doc of "@kintone/rest-api-client".
Pay attention to the class name, you should use KintoneRestAPIClientDingTalkMP in DingTalk. Refer to Sample code.

• @kintone/rest-api-client/errorHandling
• @kintone/rest-api-client/record
• @kintone/rest-api-client/app
• @kintone/rest-api-client/bulkRequest

License

• MIT

Copyright

Copyright(c) Cybozu, Inc.