개발자 문서

dowajos는 dyndns2 프로토콜 호환입니다. 공유기·NAS·클라이언트(ddclient 등) 어디서든 동일한 URL 패턴으로 호출할 수 있습니다.

업데이트 엔드포인트

GET https://dowajos.com/nic/update?hostname=<fqdn>&myip=<ip>
Authorization: Basic base64(user:pass)
User-Agent: Vendor Device/1.0 admin@example.com

hostname — 단일 또는 쉼표로 연결된 FQDN (최대 20개)
myip — 생략 시 요청 IP(X-Forwarded-For 첫 번째)를 사용합니다
Authorization — HTTP Basic(user:pass). pgcrypto 해시로 서버에서 검증됩니다.
User-Agent — 벤더/제품/이메일을 포함한 의미 있는 식별자여야 합니다.

응답 코드

good <ip> — 갱신 성공
nochg <ip> — IP 동일
nohost / notfqdn / numhost — 호스트 이름 문제
badauth / badagent / abuse — 인증·User-Agent·남용
dnserr / 911 — 서버 측 일시 오류

curl 예제

curl -u 'myuser:mypass' \
  -A 'myapp Client/1.0 admin@example.com' \
  'https://dowajos.com/nic/update?hostname=myhome.dowajos.com'

ddclient 설정

protocol=dyndns2
use=web, web=checkip.dyndns.com
server=dowajos.com
login=myuser
password=mypass
myhome.dowajos.com

Rate limit / abuse

동일 IP에 대한 반복 갱신은 nochg로 응답하며, 단기간 반복 요청이 일정 임계치를 넘으면 abuse로 전환됩니다. 클라이언트는 IP 변경 시점에만 갱신 요청을 보내도록 구현해야 합니다.