Getting Started with Kynode API in 3 Minutes

This tutorial will get you from zero to your first successful business verification in under 3 minutes.

Step 1: Get Your API Key

1. Visit kynode.dev
2. Click "Sign Up" in the top right
3. Verify your email
4. Navigate to your dashboard
5. Copy your API key (starts with sk_live_)

Important: Never share your API key or commit it to version control!

Step 2: Make Your First Request

Here's the simplest way to verify a business:

curl -X POST https://api.kynode.dev/v1/verify/business \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_number": "123-45-67890",
    "language": "en"
  }'

You'll get a response like:

{
  "valid": true,
  "business_number": "123-45-67890",
  "company_name": "삼성전자 주식회사",
  "company_name_en": "Samsung Electronics Co., Ltd.",
  "status": "Active",
  "registered_date": "2020-01-15"
}

Step 3: Integrate into Your Code

JavaScript/Node.js

const response = await fetch('https://api.kynode.dev/v1/verify/business', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.KYNODE_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    business_number: '123-45-67890',
    language: 'en'
  })
});

const data = await response.json();
console.log(data.valid ? 'Valid business!' : 'Invalid');

Python

import requests
import os

response = requests.post(
    'https://api.kynode.dev/v1/verify/business',
    headers={'Authorization': f'Bearer {os.getenv("KYNODE_API_KEY")}'},
    json={
        'business_number': '123-45-67890',
        'language': 'ko'
    }
)

data = response.json()
print('Valid business!' if data['valid'] else 'Invalid')

Step 4: Handle Errors

Always handle potential errors:

try {
  const data = await verifyBusiness('123-45-67890');
  if (data.valid) {
    // Business is valid
  }
} catch (error) {
  if (error.code === 'RATE_LIMIT_EXCEEDED') {
    // Wait and retry
  } else if (error.code === 'INVALID_API_KEY') {
    // Check your API key
  }
}

Next Steps

Now that you're up and running:

• Read the API Reference for all endpoints
• Learn about error handling
• Implement security best practices
• Set up webhooks for real-time updates

Questions? Email us at hello@kynode.dev